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ABSTRACT 


The  main  thrust  of  this  thesis  is  the  design  of  a  usable  Intelligent  Computer  Aided 
Instruction  (ICAI)  user  interface  that  does  not  require  a  natural  language  processor 
and  runs  on  a  personal  computer.  Discrete  Mathematics  is  the  knowledge  domain  for 
this  project  and  the  Discrete  Math  Tutor  (DMT)  is  the  name  of  the  tutoring  system. 
The  DMT  will  allow  the  average  student  to  benefit  from  a  tutoring  system  now  and 
not  have  to  wait  until  the  artificial  intelligence  researchers  solve  the  natural  language 
interface  problem. 
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I.  INTRODUCTION 


A.  TOO  MUCH  TO  EXPECT 

During  the  late  1970’s,  the  United  States  Army  experienced  a  phenomenon 
called  Zero  Defect  Performance.  This  phrase  means  that  commanders  accept  no 
mistakes.  Because  of  this  policy,  valuable  Army  personnel  lost  their  careers  and 
were  forced  to  retire  early.  Since  then,  saner  minds  have  prevailed  and  a  new  policy 
is  in  place.  The  Army  calls  the  new  policy  the  Band  of  Excellence.  The  Band  of 
Excellence  refers  to  an  imaginary  zone  of  acceptable  performance.  Instead  of  100% 
efficiency  all  the  time,  the  Army  considers  any  unit  that  stays  within  this  imaginary 
performance  zone  as  combat  ready. 

The  Zero  Defect  Performance  idea  is  analogous  to  the  evolutionary  process  of 
Intelligent  Computer  Aided  Instruction  ( ICAI)  systems  for  the  last  20  years.  Many 
experts  agree  that  since  their  inception,  ICAI  systems  have  not  performed  at  100% 
efficiency  (Dede,  1986,  pp.  329-353).  R.  Good  describes  three  reasons  why  ICAI 
systems  have  not  proliferated  in  the  last  decade: 

1.  There  Exists  No  Common  Database  of  How  a  Student  Learns. 

2.  There  Exists  No  Common  Database  of  How  a  Student  Learns. 

3.  There  Exists  No  Efficient  Natural  Language  Processor. 

4.  Machines  can  not  learn.  (Good,  1987,  pp.  325-342) 

A  fourth  reason  for  the  lack  of  acceptance  is  that  most  of  the  existing  systems 

like  SOPHIE,  STEAMER  and  GUIDON  all  run  on  large  mainframes  or  specialized 
equipment  (Weneger,  1986,  pp.  12-45).  Most  students  have  no  access  to  these 
types  of  machines.  Thus,  the  state-of-the-art  ICAI  systems  are  locked  away  in 
research  laboratories  and  away  from  the  average  student. 
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It  is  time  for  the  evolution  of  ICAI  systems  to  enter  the  era  of  the  Band  of 
Excellence.  Instead  of  insisting  that  ICAI  systems  keep  getting  better,  experts  must 
decide  on  the  level  of  acceptable  performance.  For  example,  since  experts  may  not 
solve  the  natural  language  processor  problem  in  the  near  future,  perhaps  it  is  not 
necessary  to  have  an  efficient  natural  language  processor  as  part  of  the  user  interface 
to  any  ICAI  system.  Further,  these  acceptable  programs  must  run  on  machines  that 
are  available  to  the  common  user. 

The  main  thru  of  this  thesis  is  the  design  of  a  usable  ICAI  user  interface  that 
does  not  require  a  natural  language  processor  and  runs  on  a  personal  computer. 
Discrete  Mathematics  is  the  knowledge  domain  for  this  project  and  the  Discrete 
Math  Tutor  (DMT)  is  the  name  of  the  tutoring  system.  The  DMT  will  allow  the 
average  student  to  benefit  from  a  tutoring  system  now  and  not  have  to  wait  until  the 
artificial  intelligence  researchers  solve  some  tough  problems. 

B.  ICAI  FEATURES 

There  are  many  ways  to  develop  ICAI  systems.  However,  most  experts  agree 
that  every  ICAI  program  must  contain  four  basic  parts:  an  Expert  Module ,  a  Student 
Module,  a  Tutorial  Module  and  the  User  Interface  Module.  Figure  1  shows  a  generic 
representation  of  any  ICAI  system.  (  Duchastel,  1989,  pp.  95-100) 
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Figure  1  -General  ICAI  Model 


The  Expert  Module  is  the  problem  solver.  It  contains  all  the  information 
concerning  how  to  solve  problems  in  the  subject  domain  and  provides  answers  to 
student  queries  based  on  the  subject  domain.  The  Student  Module  contains  all 
information  about  the  student’s  performance  level  and  reasoning  strategies.  It  stores 
a  list  of  a  student’s  misconceptions  and  sub-optimal  performance  strategies  that  he 
uses  to  solve  problems.  It  also  stores  any  skills  the  student  may  already  posses. 
The  Tutorial  Module  contains  instructional  strategies  to  apply  to  each  student  based 
on  the  information  contained  in  the  Student  Module.  It  makes  inferences  about  the 
student’s  misconceptions  and  learning  needs,  then  selects  the  best  instructional 
treatment  for  each  student.  The  User  Interface  Module  allows  the  student  to  interact 
with  the  other  three  modules.  (Seidel,  1988,  pp.  235-256) 
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C.  THE  INTELLIGENCE  PART  OF  AN  ICAI  SYSTEM 


The  degree  of  Learner  Control  inherent  in  a  ICAI  system  decides  the 
intelligence  of  that  system.  Learner  Control  means  that  the  student  has  control  of 
the  direction  of  the  lesson  path.  In  other  words,  the  student  is  not  dependent  upon 
the  software  for  each  point  in  the  lesson  plan.  LOGO  is  a  good  example  of  a  system 
that  provides  complete  Learner  Control  to  the  student  (Jones,  1985,  pp.  517-526).  In 
LOGO,  all  learning  is  based  on  discovery.  There  exists  no  teaching  strategy.  The 
student  merely  tries  what  he  thinks  will  work  and  makes  corrections  based  upon  the 
output  of  the  program. 

However,  in  intelligent  tutoring  systems,  some  teaching  must  occur.  Thus,  the 
tutoring  system  must  dictate  certain  aspects  of  a  lesson.  When  the  tutoring  system 
completely  dictates  the  entire  lesson  and  gives  no  control  to  the  student,  the  system 
is  simply  called  Computer  Aided  Instruction  (CAI).  Drill  programs  such  as  typing 
tutors  and  math  skill  programs  are  examples  of  CAI  systems.  (Duchastel,  pp.  93-98) 

An  ICAI  system  requires  a  compromise  between  CAI  and  complete  Learner 
Control.  The  compromise  is  called  a  mixed-initiative  environment  (Duchastel,  pp. 
93-98  V  The  mixed-initiative  environment  provides  some  control  to  the  student 
concerning  how  a  lesson  progresses;  but,  also,  provides  control  to  the  tutor  during 
key  points  in  a  lesson.  Therefore,  a  tutoring  system  must  implement  a  mixed- 
initiative  environment  in  order  for  it  to  be  classified  as  intelligent. 

D.  THE  DISCRETE  MATH  TUTOR  (DMT) 

The  DMT  provides  a  simple  mixed-initiative  environment.  The  environment 
contains  two  parts.  The  first  part  presents  a  standard  CAI  lesson  to  the  student. 
The  DMT  presents  each  lesson  as  pages  on  the  screen.  The  student  is  allowed  to 
page  up,  page  down,  and  even  view  a  particular  page  in  a  lesson. 
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The  second  part  provides  the  mixed-initiative  environment.  From  inside  the 
lesson,  the  student  may  access  the  DMT  user  interface.  The  DMT  user  interface 
contains  the  following  functionality: 

1.  Provides  the  user  with  the  ability  to  print  or  save  to  disk  any  definition, 
algorithm  or  example  in  the  DMT. 

2.  Provides  the  user  with  the  ability  to  run  any  algorithm  in  the  DMT  on  his  own 
data. 

3.  Provides  the  user  with  other  tools  that  aid  the  learning  process. 

These  tliree  functions  allow  the  user  to  stop  the  lesson  he  is  currently  working 
on  at  any  time  and  pursue  topics  of  interest.  For  example,  during  a  lesson  a  user  may 
find  a  term  he  does  not  remember.  All  he  has  to  do  is  access  the  DMT  user  interface 
and  look  up  the  definition  of  the  unknown  term.  Further,  during  a  problem  solving 
session,  a  user  can  access  the  user  interface’s  algorithm  section  and  determine  if  his 
answer  is  correct.  Or,  the  user  can  adjust  the  parameters  of  an  example  given  in  the 
lesson  and  view  the  resulting  change.  Finally,  the  user  can  access  any  tool  provided 
by  the  lesson  author  that  enhances  the  subject  domain. 

These  three  functions  provide  a  simple,  but  effective,  mixed-initiative 
environment  that  allows  a  user  to  learn  discrete  math.  Further,  the  DMT  runs  on  one 
of  the  IBM  PC  or  compatible  computers  that  are  prodigious  throughout  the  academic 
community. 

The  DMT  s  mixed-initiative  environment  places  the  ICAI  system  into  the 
Band  of  Excellence.  Granted,  the  DMT' s  representation  of  the  Expert  Module,  the 
Student  Module  and  the  Tutorial  Module  is  unsophisticated  at  this  time.  However, 
the  DMT  is  available  now  to  the  average  student  on  a  computer  system  that  is 
readily  accessible. 
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II.  HOW  TO  WRITE  A  LESSON 


A.  INTRODUCTION 

The  tutorial  interface  is  designed  so  that  easy  use  is  achieved.  Step-by-step 
instructions  are  provided  for  adding  either  lessons  or  question  and  answer  sessions 
to  the  tutorial  interface.  An  explanation  of  the  use  of  the  interface  is  provided  in 
Chapter  HI:  Users  Manual.  A  basic  knowledge  of  a  word  processor  is  required  to 
take  advantage  of  the  interface  so  as  to  create  a  text  type  tutorial  in  any  given 
subject.  Producing  graphic  type  tutorials  or  graphic  drill  sessions  requires  that  the 
graphics  lesson  be  independent  of  the  interface.  Programming  experience  in  a 
computer  language  such  as  C  or  Pascal  is  necessary  to  create  graphics  lessons. 

B.  CREATING  TEXT  LESSONS 

A  lesson  can  be  created  with  many  common  word  processors.  WordPerfect  5.0, 
WordStar  4.2,  or  MultiMate  3.30  are  a  sample  of  those  which  may  be  used.  The 
word  processor  or  text  editor  that  is  used  must  be  able  to  create  ASCII  (American 
Standard  Codes  for  Information  Interchange)  files. 

In  WordPerfect  5.0  text  files  are  created  by  using  the  text  in/out  key  (Ctrl-F5) 
(Kelly,  1988,  p.498).  MultiMate  3.30  requires  that  a  document  be  converted  to  ASCII 
by  using  the  advanced  utilities  menu,  file  conversion  option.  (Multimate  International 
Corporation,  1984,  p.  A-3-45).  The  ASCII  format  was  chosen  so  that  a  high  degree  of 
portability  is  assured,  and  that  ease  in  creating  a  tutorial  is  achieved. 

A  single  tutorial  subject  may  be  up  to  100  pages  long.  Each  page  will  be  no  longer 
than  19  lines.  The  first  line,  which  is  automatically  created  by  the  interface,  will 
contain  the  page  number.  The  remaining  18  lines  may  be  used  for  the  lesson  text. 
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Each  line  may  be  up  to  76  columns  in  width.  The  limitation  for  the  number  of  lines  and 
the  column  width  is  so  that  the  page  will  fit  into  a  window  which  is  19  rows  by  80 
columns.  The  window  in  which  the  pages  are  placed  is  created  by  the  interface. 

Each  page  in  the  lesson  should  be  separated  by  a  page  break.  The  page  break 
created  by  the  word  processor  should  be  interpreted  in  the  ASCII  conversion  process 
as  the  hexadecimal  number  0C.  The  page  break,  OC  hexadecimal,  is  also  known  as  a 
form  feed  (Hansen,  1989).  If  the  lesson  writer  prefers  to  create  a  lesson  with  no  page 
breaks,  die  lesson  format  program  txtmod.exe  will  size  the  lessons  to  the  correct 
length  of  18  lines.  If  txtmod.exe  is  relied  upon  to  build  the  pages,  then  it  is  possible 
that  the  material  will  not  be  presented  in  the  manner  in  which  the  lesson-writer 
intends. 

C.  FORMATTING  THE  LESSON 

After  a  lesson  is  developed,  the  lesson  fonnat  program  txtmod.exe  must  be 
executed  so  that  the  interface  and  the  lesson  are  properly  aligned.  For  example, 
suppose  that  a  lesson  has  been  written  with  a  word  processor  and  given  the  file  name 
lesson.ORG.  Next  lesson.ORG  is  converted  to  text  fonnat  (an  ASCII  file)  and 
assigned  a  new  name:  lesson.ASC.  Now  the  lesson  is  formatted  with  the  following 
command: 

txtmod  lesson.ASC  lesson.TXT 

lesson.ASC  is  the  input  file  and  lesson.TXT  is  the  output  file  to  the  executable  program 
txtmod.  lesson.TXT  is  the  file  that  will  be  used  by  the  interface  to  present  the  lesson. 
This  process  is  summarized  in  Figure  2. 
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The  input  file  and  output  file  must  have  different  names.  If  the  names  were  the 
same,  the  executable  file  txtmod.exe  will  try  to  overwrite  the  input  file  as  it  is  being 
read  and  will  produce  unpredictable  results.  As  this  is  the  case,  txtmod.exe  will  not 
allow  the  same  name  for  the  input  and  output  files. 

Other  than  the  output  file,  another  file  called  the  length  file  is  generated  by 
txtmod.exe.  The  length  file  is  created  automatically  and  without  effort  on  the  part  of 
the  user.  The  length  file  consists  of  an  array  which  contains  the  number  of  bytes 
between  page  breaks.  It  is  the  information  which  is  stored  in  the  length  file  that 
allows  the  interface  to  provide  for  next  page,  previous  page,  and  individual  page 
selection.  The  length  file  is  given  the  same  name  as  the  output  file  but  is  given  the 
extension  LEN . 


1.  Write  the  lesson  with  save  to 

a  word  processor 

2.  Convert  the  lesson  convert  to 

to  an  ASCII  file 

3.  Format  the  lesson 

with  the  command  produces 

txtmod  lesson.ASC  lesson.TXT 


Figure  2  -Process  of  Formatting  a  Lesson 


FILE  NAME 

lesson.ORG 


lesson.ASC 


lesson.TXT 

Iesson.LEN 
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D.  CREATING  TEXT  EXAMS 


The  interface  has  provisions  for  presenting  text  type  question  and  answer  exams. 
The  exams  may  be  of  type  true/false  and/or  multiple  choice.  An  exam  bank  is  a  file 
which  may  consist  of  up  to  100  questions.  The  student  will  be  allowed  to  select  any 
number  up  to  the  number  of  questions  in  the  exam  bank.  The  questions  will  be 
presented  in  random  order.  At  the  desire  of  the  lesson- writer,  explanations  may  be 
provided  for  the  questions. 

An  explanation  bank  is  a  file  which  contains  explanations  for  the  corresponding 
questions.  Providing  an  explanation  bank  is  optional.  But,  if  an  explanation  bank  is 
given,  an  explanation  page  must  be  provided  for  each  question  in  the  corresponding 
question  bank.  This  is  required  so  that  the  questions  and  explanations  are  properly 
aligned.  If  it  is  preferable  to  provide  explanations  for  some  questions  and  not  for 
others,  a  statement  such  as  "Explanation  not  provided  for  this  question"  should  be 
used  for  the  appropriate  page  in  the  explanation  bank. 

Producing  questions,  answers,  and  explanations  with  the  interface  is  similar  to 
constructing  lessons  except  that  a  specific  fonnat  must  be  used  to  create  a  question. 
Questions  and  explanations  may  be  at  most  18  lines  long.  As  shown  in  Figure  3, 
correct  answers  to  questions  must  be  bracketed  with  the  @  (at  sign)  symbol. 


Is  this  the  correct  format  for  a  question? 

@yes<S) 

no 


Figure  3  -Question  Format  for  Exam  Bank 
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Notice  that  no  blanks  are  allowed  between  the  @  (at  sign)  and  the  correct 
answer.  The  interface,  through  use  of  the  executable  program  Qjk_A.exe  ,  will  strip 
the  @  brackets  from  the  correct  answer  and  present  the  correct  answer  so  that  it  is 
aligned  with  the  other  answers.  This  is  shown  in  Figure  4.  The  @  is  required  so  that 
the  correct  answer  is  highlighted  (reverse  video)  in  response  to  an  answer  proposed 
by  the  user  (see  Figure  15).  A  word  processor  such  as  those  mentioned  above  should 
be  used  to  create  ASCII  files  for  both  the  question  bank  and  the  explanation  bank. 
Then  the  lesson  format  program  txtmod.exe  must  be  executed  on  each  of  the  ASCII 
files  so  that  the  interface  and  the  exam  are  properly  aligned.  As  with  the  lesson, 
length  files  are  created  by  txtmod.exe  for  both  the  question  and  explanation  files. 


Is  this  the  correct  format  for  a  question? 

yes 

no 


Figure  4  -Question  Presentation  in  the  DMT 

E.  CREATING  GRAPHICS  LESSONS  AND  EXAMS 

In  the  introduction,  it  was  noted  that  a  graphics  lesson  must  be  independent  of  the 
interface.  That  is,  any  graphically  oriented  lesson  must  be  provided  in  an  executable 
file.  This  is  because  there  are  no  special  provisions  or  restrictions  in  the  interface  for 
producing  graphics.  Also,  because  graphical  lessons  are  independent  of  the  interface, 
the  lesson-writer  may  produce  graphics  lessons  with  a  computer  language  of  choice. 


10 


As  illustrated  in  Figure  17,  a  graphics  lesson  is  not  displayed  in  the  lesson 
window  that  is  provided  with  the  interface.  This  is  because  the  windows  and  menus 
created  by  the  interface  are  developed  in  the  text  mode  instead  of  the  graphics  mode. 
Consequently,  a  program  that  produces  graphical  lessons  or  exams  must  first  identify 
the  graphics  hardware  installed  on  the  computer.  Next,  the  program  must  clear  the 
text  screen  and  initialize  the  graphics  system.  After  initializing  the  graphics  system, 
presentation  of  the  graphically  oriented  lesson  is  possible.  It  should  be  noted  that 
since  a  graphics  lesson  is  not  presented  in  the  interface  window,  the 
aforementioned  display  restrictions  of  19  rows  by  76  columns  do  not  apply. 

After  the  lesson  is  presented  and  it  is  desired  to  return  to  the  interface,  the 
graphics  program  must  clear  the  graphics  device  from  the  system.  After  clearing  the 
graphics  device,  the  text  mode  must  be  reinstalled.  The  interface  will  then 
reestablish  the  windows  and  menus  and  return  the  user  to  the  lesson  from  which  he 
came.  Examples  of  graphic  type  lessons  and  exams  are  provided  in  Chapter  III:  Users 
Guide. 

F.  MEMORY  CONSIDERATIONS 

The  DMT  was  designed  to  run  on  a  personal  computer  (PC)  with  640  kilobytes  of 
RAM.  Thus,  640K  is  an  upward  limit  for  how  large  the  program  can  grow.  The  DMT 
currently  uses  2C*  K  of  RAM  while  executing.  The  fact  that  only  one  of  four  modules 
of  the  DMT  has  been  implemented  makes  the  remaining  440K  of  RAM  a  critical 
commodity. 

With  this  is  mind,  the  DMT  was  designed  with  a  special  programming  technique 
used  in  large  programs  called  layering.  It  involves  converting  the  major  functions  of  a 
program  into  executable  files.  Instead  of  the  main  module  of  the  interface  calling 
individual  C  Language  functions,  the  main  module  actually  suspends  operation  of  itself 


11 


and  calls  other  layered  programs.  Once  the  layered  program  finishes  executing, 
control  is  returned  to  the  DMT’s  main  module.  Thus,  as  long  as  the  main  module  and 
any  other  layered  program  together  do  not  exceed  the  640K  upper  bound,  the  number 
of  layered  programs  that  can  be  added  to  the  complete  program  is  unlimited. 

The  DMT  consists  of  a  main  program  and  a  number  of  layered  programs.  The 
main  module  is  called  dmt.exe  and  is  the  actual  interface  to  the  program.  When  the 
program  begins,  dmt.exe  always  exists  in  RAM. 

The  key  layered  program  in  the  tutor  is  called  lsn.exe  and  is  the  executable  file 
that  displays  lessons  to  the  user.  This  layered  program  is  critical  because  it  will 
usually  always  co-exist  in  RAM  with  the  dmt.exe  interface  program  since  displaying 
lessons  is  the  main  function  to  the  tutor. 

As  shown  in  Figure  5,  both  dmt.exe  and  lsn.exe  combine  to  use  200K  of  RAM. 
Therefore,  only  440K  of  RAM  is  available  for  all  other  layered  programs  in  the  tutor. 
This  seems  to  be  sufficient  since  all  the  other  layered  programs  that  already  exist 
inside  the  tutor  are  well  below  the  440K  maximum. 
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Figure  5  -DMT  Memory  Model 


G.  ADDING  GRAPHICS  TO  LESSONS 

The  DMT  utilizes  Mike  Smedley’s  windowing  package  called  the  C  Extended 
Library  (CXL)  (Smedley,  1989).  As  mentioned  previously,  CXL  does  not  support 
both  graphical  and  textual  modes  simultaneously.  If  a  picture  is  required  to  enhance  a 
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lesson,  that  picture  is  included  as  a  tool  inside  the  tutor  interface.  The  lesson  text 
must  inform  the  student  to  locate  the  needed  image  inside  the  tool  box  for  viewing. 
Thus,  all  pictures  required  in  a  lesson  become  small  executable  files,  layered 
programs  (see  previous  section),  that  are  called  from  the  "TOOLS"  pull-down  menu 
inside  the  DMT. 

H.  ADDING  LESSONS,  EXAMS  AND  TOOLS  TO  THE  INTERFACE 

Adding  lessons,  exams  and  tools  to  the  interface  is  a  two  step  process.  First,  the 
author  must  create  these  items.  The  previous  sections  in  this  chapter  discuss  this 
process.  Second,  the  author  must  add  each  new  item  to  the  menuing  system 
presented  to  the  student. 

The  CXL  package  provides  an  easy  mechanism  to  provide  pull-down  menus  to  the 
user.  The  basic  structure  to  each  pull-down  menu  already  exists  in  the  DMT  and  is 
well  documented  in  the  CXL  Documentation  Book  (  Smedley,  1989).  In  general, 
however,  the  author  calls  a  CXL  function  that  defines  the  menu  name  and  the  name  of 
the  function  that  will  execute  once  the  menu  item  is  chosen.  This  executing  function 
uses  the  spawnl  function  provided  by  the  Turbo  C  Library  to  suspend  operation  of  the 
interface  program  and  run  some  other  executable  file.  This  process  is  called  spawning 
a  program. 

In  the  case  of  a  new  lesson,  the  executable  file,  lsn.exe,  is  called  with  the  name  of 
the  new  lesson’s  text  file  included  as  a  command  line  argument.  In  the  case  of  a  new 
exam,  the  executable  file,  exam.exe,  is  called  with  the  name  of  the  new  exam’s  text 
file  included  as  a  command  line  argument.  Finally,  for  new  tools,  the  tool’s 
executable  file  is  called  with  no  command  line  argument.  In  all  cases,  control  is 
returned  to  the  DMT  interface  once  the  spawned  program  terminates. 
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ni.  USERS  GUIDE 


A.  INTRODUCTION 

The  Discrete  Math  Tutor  is  started  from  the  operating  system  command  line 
prompt  by  typing  the  command,  DMT  ,  inside  the  directory  that  holds  the  DMT  files 
(See  Appendix  C  for  details  on  installing  the  program  on  a  hard  drive).  The  first 
screen  that  appears  is  the  introduction  and  is  shown  in  Figure  6.  From  the 
introduction,  the  user  has  four  options  which  may  be  selected  by  pressing  designated 
keys  known  as  hot  keys. 


Welcome  to  the  Discrete  Math  Tutor  (DMT)  Prototype 

DMT  :  1989-1990 
by 

Rick  Howard 
& 

Keith  Calcote 


■Start  Demo 
Exit  Demo 


H-  Help  ECS  -  Quit 


Figure  6  -Introduction  Screen 
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The  first  hot  key,  case  sensitive  help,  is  invoked  by  typing  the  letter  H.  Help  is 
available  throughout  the  tutor,  and  the  following  description  is  common  to  all  help 
menus.  If  help  is  selected,  an  introduction  to  the  available  help  is  displayed.  With  the 
exception  of  the  Esc  key,  the  operation  of  all  hot  keys  is  suspended  while  help  is 
active.  The  help  screen  describes  the  hot  keys  and  explains  other  information 
pertinent  to  interface  operations  that  are  specific  to  the  particular  location  in  the  tutor. 
If  additional  help  is  available,  PgUp  and/or  PgDn  is  displayed  at  the  bottom  right  hand 
comer  of  the  screen.  PgUp  indicates  that  the  previous  page  of  help  may  be  selected  by 
typing  the  page  up  key.  PgDn  signifies  that  the  next  page  of  help  is  available  by 
typing  the  page  down  key.  Typing  the  Esc  key  will  exit  the  help  screen.  Typing  the 
Esc  key  again  will  exit  the  Tutor  and  return  the  user  to  the  operating  system. 

The  second  hot  key,  escape  (Esc),  is  available  from  the  introduction  screen  to  quit 
the  Tutor.  Selecting  Esc  from  the  introduction  will  return  the  user  to  the  operating 
system.  Also,  the  escape  key  is  accessible  throughout  the  tutor  to  back  out  of  the 
menus. 

The  third  hot  key  for  the  introduction  is  E.  Typing  E  or  selecting  Exit  Demo  with 
the  cursor  and  pressing  enter  will  quit  the  Tutor  and  return  the  user  to  the  operating 
system. 

The  last  hot  key  for  the  introduction,  S,  is  used  to  start  the  demonstration.  The 
demonstration  may  also  be  started  by  selecting  Start  Demo  with  the  cursor  and 
pressing  enter.  When  Start  Demo  is  selected  a  blank  opening  screen  is  displayed. 
Figure  7  shows  the  tutorial  opening  screen. 
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Begin  Information  Exams  Tools  Notebook  Quit 


The  menu  b:.  across  the  top  of  the  opening  screen  is  called  the  main  menu  and 
contains  selectable  options  incorporated  in  the  interface.  The  blank  portion  of  the 
screen  is  where  the  lesson  is  displayed.  The  bottom  portion  of  the  screen  includes 
additional  information  or  directions  available  to  the  user. 

B.  BEGIN 

The  interface  provides  two  ways  to  begin  a  lesson.  A  lesson  may  be  stalled 
with  the  first  page  in  the  lesson,  or  it  may  be  started  with  the  last  active  page  of 
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previous  session.  To  start  the  lesson,  Begin  is  selected  from  the  main  menu  by  typing 
the  hot  key,  B.  Figure  8  displays  the  opening  screen  with  the  Begin  menu  selected. 


From  the  begin  menu  the  user  has  two  options,  Start  a  Lesson  or  Return  to  Last 
Lesson.  Either  of  these  two  options  are  selected  by  cursor  or  by  hot  keys  (S  for  Start 
a  Lesson  or  R  for  Return  to  Last  Lesson). 

If  Start  a  Lesson  is  chosen,  a  menu  of  available  lessons  is  presented.  This  is 
shown  in  Figure  9.  Once  the  available  lessons  are  listed,  the  selection  is  made  by 
moving  the  cursor  to  the  desired  lesson  and  pressing  enter. 


H  -  Help  ESC  -  Back  up 


Figure  8  -Selection  of  the  Begin  Menu 
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Figure  10  displays  the  screen  that  is  presented  when  Return  to  Last  Lesson  is 
selected  from  the  Begin  menu.  The  user  is  prompted  to  enter  his  or  her  social  security 
number  (ssn).  The  ssn  is  used  to  provide  unique  cataloging  of  multiple  users.  When 
the  user  enters  his  or  her  ssn,  the  interface  locates  and  displays  the  last  active  page 
of  the  last  lesson  that  corresponds  to  that  ssn. 


Figure  9  -Logic  Lesson  Selected  from  Menu 
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Begin  Information 

Exams  Tools  Notebook  Quit 

f 

Start  a  Lesson 

1 

1 

Return  to  Last  Lesson 

1 

1 

Enter  your  social  security  number  I  1-  L  1-1  U 

H  -  Help  ESC  -  Back  up 


Figure  10  -  Social  Security  Number  Required  to  Return  to  Last  Lesson 

C.  MANEUVERING  INSIDE  A  LESSON 

A  sample  of  a  display  of  a  lesson  is  provided  in  Figure  11.  The  page  number  is 
listed  in  the  top  right  hand  comer  of  the  lesson.  Pages  may  be  selected  by  typing  the 
two  key  combination  Alt  P,  and  entering  the  desired  page  number.  If  a  page  is 
selected  that  is  out  of  bounds  of  the  present  lesson  (e.g.,  page  60  is  selected  but  the 
lesson  is  only  40  pages  long),  the  lesson  is  started  over  at  page  one.  The  page  up  key 
may  be  used  to  select  the  previous  page  and  the  page  down  key  may  be  used  to 
select  the  next  page.  If  the  page  up  key  is  used  when  the  lesson  is  on  the  first  page, 
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the  lesson  is  wrapped  to  the  last  page.  Similarly,  if  the  page  down  key  is  used  when 
the  lesson  is  on  the  last  page,  the  lesson  is  wrapped  to  the  first  page. 


Begin  Information  Exams  Tools  Notebook  Quit 

Page  3 

Statements 

Propositional  logic  concerns  declaratory  statements.  That  is, 
statements  which  are  either  TRUE  or  FALSE  but  NOT  BOTH  are  called 
PROPOSITIONS. 


1 - [  PgUp/PgDn  ] - 

H  -  Help  ALT  P-Find  Page  #  ESC  -  Back  up 


Figure  11  -Display  of  a  Sample  Lesson 


D.  INFORMATION 

The  information  section  was  designed  so  that  the  student  user  has  review 
material  available  for  quick  access.  The  selected  material  may  be  added  to  the  user’s 
notebook  (described  later  in  this  section)  or  may  be  directed  to  the  printer  for  hard 
copy.  This  feature  allows  the  student  to  store  and  later  retrieve  material  that  he  or 
she  identifies  as  needing  additional  study. 
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Information  is  chosen  from  the  main  mem  by  typing  the  hot  key  I.  Definitions, 
examples,  theorems,  and  proofs  are  selectable  from  the  information  menu.  Once  the 
type  of  information  is  selected,  a  list  of  available  items  are  displayed.  The  user  makes 
a  selection  by  moving  the  cursor  to  the  desired  item  on  the  list  and  typing  enter.  As 
shown  in  Figure  12,  the  definition  of  a  graph  is  chosen  from  the  list  of  definitions 
while  a  lesson  remains  active  in  the  background. 


Begin  Information  Exams  Tools  Notebook  Quit 


Statements 
Propositional 
statements  wl{ 


Definitions 

Examples 

Theorems 

Proofs 


Page  3 

statements.  That  is, 

KLSE  but  NOT  BOTH  are  called 


PROPOSITIONS. 


You  selected  :  Graph 


Add  Definition  to  Notebook 


Print  Definition 


H  -  Help 


.[  PgUp/PgDn  ]- 


ALT  P-Find  Page  # 


ESC  -  Back  up 


Figure  12  -The  Definition  of  a  Graph  is  Selected  to  Add  to  the  Notebook 


After  the  selection  is  made,  the  user  is  presented  with  two  options.  The  item  may 
be  added  to  the  notebook  with  the  hot  key,  N,  or  directed  to  the  printer  with  the  hot 
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key,  P.  Also,  either  of  the  options  may  be  selected  by  the  cursor.  The  user  is 
cautioned  to  ensure  that  the  printer  is  turned  on  prior  to  typing  the  hot  key,  P.  If  the 
notebook  option  is  selected,  the  user  is  asked  to  provide  the  name  of  the  notebook 
and  asked  whether  the  item  should  be  appended  to  or  overwrite  the  notebook.  Again, 
the  user  is  cautioned  that  if  the  overwrite  option  is  chosen,  all  contents  of  the 
notebook  are  erased  prior  to  writing  the  item  to  the  notebook.  Figure  13  displays  the 
screen  that  results  when  add  to  the  notebook  is  selected.  After  the  task  is  completed, 
the  user  is  returned  to  the  page  in  the  lesson  from  which  he  came. 


Begin  Information  Exams  Tools  Notebook  Quit 


Definitions 

Examples 

Theorems 

Proofs 


Statements 
Propositional 
statements  wl 
PROPOST[  Name  Your  Personalized  Notebook  ]- 

What  is  your  Notebook  Name?  _ 

(A)ppend  or  (O)verwrite? 


Page  3 

statements.  That  is, 
kLSE  but  NOT  BOTH  are  called 


Add  Definition  to  Notebook) 


Print  Definition 


- T  PgUp/PgDn  I - 

H  -  Help  ALT  P-Find  Page  #  ESC  -  Back  up 


Figure  13  -Notebook  Name  is  Requested 
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E.  EXAMS 


The  exams  section  is  provided  to  allow  the  user  to  test  his  or  her  knowledge  of  a 
particular  area.  Exams  is  selected  from  the  main  menu  by  typing  the  hot  key,  E. 
Subsequently,  a  list  of  exams  are  presented.  A  particular  exam  may  be  chosen  by 
moving  the  cursor  to  the  name  of  the  exam  in  the  list  and  pressing  the  enter  key. 
Selection  of  an  exam  is  shown  in  Figure  14. 


Begin  Information  Exams  Tools  Notebook  Quit 


[Logic  Exam 


~[  Enter  the  Number  of  Exam  Questions  Desired  ] 
How  many  exam  questions  do  you  wish?  05 


H  -  Help  ESC  -  Back  up 


Figure  14  -Selection  of  Logic  Exam 
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When  a  particular  exam  is  chosen,  the  user  is  asked  to  enter  the  number  of 
questions  that  are  desired.  The  user  must  respond  with  a  two  digit  number  from  01  to 
99.  If  die  user  asks  for  more  questions  than  are  available,  a  message  is  displayed 
that  shows  the  total  number  of  questions  which  are  available  for  that  exam.  The  user 
is  then  returned  to  the  lesson. 

Once  the  exam  is  selected  and  the  number  of  questions  are  entered,  a  random 
selection  process  is  used  to  present  exam  questions  to  the  screen.  Questions  are 
answered  by  typing  the  letter  of  the  corresponding  selection  for  multiple  choice 
questions  and  by  typing  either  t  or  f  for  true/false  questions.  After  the  selection  is 
entered,  a  message  is  displayed  indicating  whether  the  selection  was  correct  or 
incorrect.  Also,  the  correct  answer  is  highlighted.  If  explanations  have  been 
provided,  typing  the  hot  key,  E,  will  display  an  explanation  for  the  corresponding 
question.  Figure  15  shows  a  question  with  the  solution  highlighted.  New  questions 
are  introduced  until  the  desired  number  of  questions  have  been  presented.  After  the 
last  question,  a  results  screen  is  displayed. 
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Your  answer  b  was  INCORRECT. 


Which  of  the  following  is  a  statement? 

a.  Write  a  program  that  calculates  factorials. 

b.  Why  are  there  so  many  real  numbers? 

c.  Who  is  the  instructor  for  your  discrete  math  class? 

d.  The  road  is  bumpy. 


E  for  explanation,  enter  to  continue. 

H  -  Help  ESC  -  Back  up 


Figure  15  -Exam  Question  with  Answer  Highlighted 


F.  TOOLS 

Tools,  selected  from  the  main  menu  by  typing  the  hot  key  T,  provides  the  user 
with  instruments  that  augment  the  lessons  and  which  aid  in  the  student’s 
understanding  of  key  concepts.  Figure  16  shows  the  interface  with  a  lesson  in  the 
background  and  the  tools  menu  selected.  From  the  tools  menu,  diagrams,  reference, 
calculator,  or  problem  solver  may  be  selected. 
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Tools  Notebook  Quit 

Diagrams 

Page  3 

Reference 

Statements 

Calculator 

Propositional  logic  concerns  declarato 

Problem  Solver 

is. 

statements  which  are  either  TRUE  or  FALSE  but  NOT  BOTH  are  called 
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Figure  16  -Selection  of  the  Tools  Menu 


1.  Diagrams 

A  demanding  concept  or  idea  may  be  presented  or  practiced  pictorially.  Dia¬ 
grams,  selected  from  the  tools  menu,  are  used  to  graphically  rehearse  the  user.  At 
this  time,  the  Venn  diagram  drill  is  available  through  this  selection.  Figure  17  shows 
an  example  of  a  Venn  diagram  drill  session. 
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A  UNION  B  UNION  C  ? 


Select  1-8  to  fill,  E  to  erase,  Q  to  quit  Enter  to  continue 


Figure  17  -Venn  Diagram  Drill  Session 


The  drill  session  consists  of  a  randomly  generated  Venn  diagram  problem. 
The  problem  is  displayed  at  the  top  of  the  screen.  Three  circles  are  drawn  in  the  cen¬ 
ter  of  the  screen  and  represent  three  sets  A,  B,  and  C.  The  regions  of  intersection  are 
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numbered  from  one  to  eight.  The  bottom  of  the  screen  contains  instructions  and  re¬ 
sults. 

The  user  is  asked  to  select  the  number  or  number^  tha*  correspond  to  the  re¬ 
gions  which  would  be  contained  in  the  set  of  the  posed  question.  As  the  numbers  are 
selected,  the  corresponding  region  is  shaded.  The  user  may  erase  his  or  her  choices 
and  be  presented  with  the  original  problem  by  typing  the  hot  key  E.  Once  the  region 
or  regions  are  selected,  the  user  presses  the  enter  key.  Then,  the  user’s  answer  is 
processed  and  either  CORRECT  or  INCORRECT  is  displayed  in  the  bottom  right 
hand  comer  of  the  screen.  If  the  answer  is  correct,  the  next  question  is  presented  af¬ 
ter  the  enter  key  is  pressed.  If  incorrect,  the  correct  solution  is  shown  before  the  next 
question  is  presented.  The  user  may  quit  the  Venn  diagram  drill  and  return  to  the 
same  point  in  the  lesson  from  which  he  came  by  typing  the  hot  key  Q. 

2.  Reference 

A  quick  reference  to  review  key  concepts  or  ideas  is  made  available  in  this 
tool.  Reference,  selected  from  the  tools  menu,  is  used  to  rapidly  refresh  the  user’s 
memory  in  the  chosen  area.  Figure  18  shows  that  quick  reference  is  available  for  Venn 
diagrams  and  truth  tables  and  is  selected  from  the  tools  menu. 

a.  V,  in  Diagrams 

The  Venn  diagram  quick  reference  begins  with  a  menu  of  available 
Venn  diagram  drawings.  The  user  selects  the  letter  corresponding  to  the  desired 
picture  and  types  enter.  Figure  19  displays  an  example  of  the  resulting  drawing.  The 
desired  relationship  is  displayed  at  the  top  of  the  screen.  Three  circles  are  drawn  in 
the  center  of  the  screen  that  represent  three  sets  A,  B,  and  C.  The  area  that 


29 


corresponds  to  the  chosen  relationship  is  shaded.  The  user  may  quit  the  Venn 
diagram  reference  and  return  to  the  lesson  by  typing  the  hot  key  Q. 
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Figure  18  -Reference  Available  for  Truth  Tables  and  Venn  Diagrams 
b.  Truth  Tables 

There  are  two  choices  for  truth  table  quick  reference  and  they  are  drill 
or  rules.  The  rules  section  contains  a  selection  of  four  basic  truth  tables.  The  truth 
tables  are  chosen  by  typing  one  of  four  function  keys;  FI,  F2,  F3,  or  F4.  As  shown  in 
Figure  20,  the  basic  truth  tables  are  displayed  in  a  window  located  at  the  top  right 
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hand  comer  of  the  screen.  Typing  any  key  other  than  the  four  function  keys  will  return 
the  user  to  the  lesson. 


Figure  19  -Sample  of  a  Venn  Diagram  Quick  Reference  Drawing 
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The  drill  division  of  the  truth  table  quick  reference  includes  flash  card 
like  practice  for  the  student.  An  example  of  the  truth  table  flash  cards  is  illustrated  in 
Figure  21.  The  user  is  presented  with  a  randomly  selected  basic  relationship  and 
asked  to  determine  its  truth  value.  Once  the  user  decides  on  the  truth  value,  he  or  she 
types  "T"  for  true  or  "F"  for  false.  Then,  a  comparison  is  made  between  the  given 
answer  and  the  computed  answer.  If  the  user’s  answer  is  correct,  then  "correct"  is 
displayed  below  the  flash  card.  If  incorrect,  then  "wrong"  is  displayed.  After  a  short 
delay,  a  new  flash  card  is  presented  and  the  process  is  repeated.  The  student  may 
quit  the  flash  cards  by  typing  Q.  After  Q  is  typed,  the  results  of  the  flash  card  session 
are  displayed  as  shown  in  Figure  22.  From  the  results  screen,  typing  any  key  will 
return  the  user  to  the  lesson. 
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Figure  20  -Display  of  the  Quick  Reference  Basic  Truth  Table 
3.  Calculator 

This  instrument  is  available  in  the  tools  menu  (see  Figure  16)  and  is  provid¬ 
ed  so  that  the  user  may  perform  simple  mathematical  operations  without  the  need  of 
an  external  calculator.  Calculator  will  perform  basic  addition,  subtraction,  multiplica¬ 
tion,  and  division.  The  user  may  quit  the  calculator  by  typing  the  escape  key. 
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Figure  21  -Display  of  Truth  Table  Flash  Card 
4.  Problem  Solver 

The  problem  solver  is  designed  to  build  arbitrary  truth  tables  of  moderate 
size.  This  tool  provides  the  student  with  the  means  to  check  truth  table  problems  and 
provides  the  ability  to  explore  truth  tables  of  his  or  her  own  design.  The  truth  table 
problem  solver  is  available  in  the  tools  menu  (see  Figure  16). 
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Figure  22  -Results  Screen  for  the  Flash  Card  Session 

Problems  may  be  explored  using  four  variables  (p,q,r,s).  The  variables  may 
be  entered  as  either  upper  or  lower  case,  but  they  are  all  converted  to  upper  case  by 
the  solver.  That  is,  Q  and  q  are  treated  as  the  same  variable,  Q,  by  the  solver.  The 
solver  allows  use  of  five  operators  which  are  listed  below: 

1 .  ~  (negation), 

2.  &  (and), 

3.  I  (or), 

4.  >  (implication), 

5.  =  (equivalence). 
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The  hierarchy  that  the  problem  solver  obeys  is  given  as  follows: 

1.  negation  of  variables, 

2.  operations  inside  parentheses, 

3.  negation  of  operations  inside  parentheses, 

4.  and’s, 

5.  or’s, 

6.  implications, 

7.  equivalences. 

Also,  operations  are  executed  from  left  to  right. 

After  the  expression  is  typed  onto  the  screen  and  the  user  types  enter 
(<CR>),  the  solver  calculates  and  displays  the  appropriate  truth  table.  A  complete 
breakdown  of  the  truth  table  is  displayed  so  that  the  user  may  follow  the  solution 
step-by-step.  The  breakdown  of  propositions  is  listed  above  the  display  of  the  truth 
table. 

For  example,  in  Figure  23  the  expression  ~(plq)  =  -P&-Q  is  investigated. 
The  fourth  term  evaluated  by  the  solver  is  P4  and  is  given  as  ~(PIQ).  The  last  term, 
P6,  is  the  originally  posed  relation.  Below  the  propositions  is  the  truth  table.  To  quit 
problem  solver  and  return  to  the  lesson,  the  user  types  the  escape  key. 
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Figure  23  -Example  of  the  Truth  Table  Problem  Solver 


G.  NOTEBOOK 

The  notebook  is  a  file  that  contains  information  that  the  user  deems  necessary  to 
isolate  for  further  study.  Items  listed  in  the  information  section  may  be  entered  into 
the  notebook.  The  notebook  may  be  displayed  to  the  screen  or  sent  to  the  printer  for  a 
hard  copy.  If  the  notebook  is  displayed  to  the  screen,  the  information  in  the  notebook 
is  treated  as  though  it  were  lesson  text.  This  means  that  maneuvering  inside  the 
notebook  is  the  same  as  maneuvering  inside  a  lesson  (described  previously).  To  quit 
viewing  the  notebook  the  student  must  select  the  quit  menu  with  the  hot  key  Q. 
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Then,  from  the  quit  menu,  exit  is  selected.  The  user  is  then  returned  to  the  same  point 
in  the  lesson  from  which  he  came. 

H.  QUIT 

Prior  to  quitting  the  lesson,  the  user  has  the  option  of  saving  his  or  her  position  in 
the  lesson.  This  option,  available  in  the  quit  menu,  is  provided  so  that  the  user  may 
start  the  next  session  on  the  current  page  of  the  present  lesson.  The  quit  menu, 
displayed  in  Figure  24,  contains  two  options.  The  two  options  are:  save  the  current 
position  and  exit. 

If  save  the  current  position  is  selected,  the  user  is  prompted  to  enter  his  or  her 
social  security  number.  After  the  ssn  is  entered,  the  user  is  returned  to  the  operating 
system.  For  those  who  do  not  care  to  save  their  last  position,  the  exit  option  may  be 
selected  by  typing  the  hot  key  E.  By  choosing  exit  from  the  quit  menu,  the  user  is 
immediately  returned  to  the  operating  system  without  regard  to  the  present  position. 
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Figure  24  -Quit  Menu  is  Selected 


IV.  FURTHER  WORK 


A.  INTRODUCTION 

The  DMT  User  Interface  Design  Document  (See  Appendix  B)  describes  the 
relationships  between  the  four  main  modules  to  the  system:  the  Expert  System,  the 
Tutor  Model,  the  Student  Model  and  the  User  Interface.  Figure  46  of  Appendix  B 
shows  that  the  User  Interface  is  the  main  hub  for  data  communications  between  the 
four  modules.  Therefore,  implementation  of  the  DMT  User  Interface  module  before 
the  other  three  modules  is  required.  This  thesis  accomplishes  that  task. 

Although  the  User  Interface  is  operational,  more  work  is  needed  to  make  the 
DMT  a  complete  ICAI  system.  First,  testing  the  User  Interface  on  real  users  will 
discover  the  strengths  and  weaknesses  of  the  design.  Second,  based  on  the  test 
results  and  based  on  already  known  extensions,  the  modification  of  the  User  Interface 
will  make  it  more  user  friendly  and  more  effective.  Finally,  implementing  the  other 
three  modules  will  make  the  DMT  a  complete  ICAI  system. 

B.  TESTING 

The  DMT,  as  it  now  exists,  is  simply  a  prototype.  Everything  the  program  does 
merely  shows  what  is  possible.  No  real  lesson  in  discrete  math  exists.  Therefore, 
development  of  complete  discrete  math  lessons  is  die  next  important  task.  Once  the 
lessons  are  complete,  testing  can  begin  on  real  students. 

The  testing  procedure  should  answer  two  distinct  questions:  (1)  how  effective  is 
the  DMT  at  teaching  the  subject  domain,  and  (2)  what  are  the  unknown  bugs  in  the 
program. 
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Testing  the  effectiveness  of  the  DMT  is  not  a  trivial  matter.  Testing  must 
evaluate  the  effectiveness  of  the  interface  and  the  effectiveness  of  the  instruction 
separately.  For  instance,  it  is  possible  to  combine  an  ineffectual  lesson  with  an 
effective  interface  and  vice  versa.  The  other  possibilities  are  that  the  lesson  and  the 
interface  are  both  effective  or  diat  they  are  both  ineffective.  The  tester  must 
distinguish  between  these  possibilities  and  provide  ideas  on  how  to  improve  the 
interface  design  or  the  development  of  each  individual  lesson. 

Testing  for  unknown  bugs  is  not  an  easy  matter  either.  A  logical,  systematic 
approach  is  required  to  ensure  that  most  of  the  major  program  deficiencies  are  found. 
When  a  bug  is  identified,  correcting  the  bug  becomes  a  priority.  If  a  bug  is  not 
correctable,  then  that  bug  impacts  upon  the  effectiveness  of  the  interface. 

After  completion  of  all  tests,  the  tester  must  conclude  one  of  two  possibilities:  the 
DMT  is  an  effective  user  interface  or  it  is  not. 

C.  INTERFACE  EXTENSIONS 

Although  the  DMT  is  a  working  prototype,  extensions  to  the  existing  software 
will  make  the  system  more  user  friendly  and  more  effective. 

Presently,  it  is  not  possible  for  a  non-prog  rammer  to  modify  the  interface.  All 
menus  are  hard  coded  using  Mike  Smedley’s  C  Extended  Library  (CXL) 
(Smedley,1989).  Thus,  to  add  any  new  lesson  to  the  DMT,  a  C  language  programmer 
must  physically  change  the  existing  DMT  code.  The  major  disadvantage  in  this 
situation  is  the  time  it  takes  to  become  familiar  with  both  the  CXL  functions  and  the 
existing  DMT  code.  It  is  anticipated  that  most  lesson  writers  for  the  DMT  will  not 
have  a  programming  background.  In  order  to  make  it  easy  to  add  lessons  to  the 
DMT,  development  of  an  automated  menu  generation  tool  is  required. 
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Currently,  the  DMT  does  not  allow  the  user  any  text  editing  capabilities.  Most 
input  from  the  user  is  taken  from  hot  keys  off  the  keyboard  which  allows  the  user  to 
manipulate  the  menuing  system.  This  type  of  system  lends  itself  nicely  to  using  a 
mouse  as  an  input  device.  Providing  mouse  support  to  the  user  will  allow  him  to 
point  &  shoot  where  he  needs  to  go  instead  of  remembering  a  plethora  of  unfamiliar 
keyboard  commands.  Smedley’s  CXL  package  contains  functions  that  support  mouse 
implementation. 

One  of  the  original  assumptions  of  this  project  is  that  most  students  interested  in 
this  type  of  instructional  software  will  have  access  to  an  AT  class  computer  with  an 
80286  CPU.  Although  this  assumption  is  correct  today,  in  five  years  it  may  not  be 
true.  In  recent  PC  periodicals  like  BYTE  and  Dr.  Dobbs,  the  80286  CPU  machine  is 
rarely  mentioned.  The  next  generation  CPU’s  like  the  80386  and  80486  are  the 
computers  that  will  be  available  to  students  in  the  next  decade  (Irresistible  VGA, 
1990),  (MAC  Hfx,  1990),  (Mainstream  Amiga,  1990)  &  (Memory  Management, 
1990).  Therefore,  upgrading  the  DMT  to  run  on  one  of  these  machines  to  take 
advantage  of  their  unique  abilities  may  increase  the  effectiveness  of  the  Tutor. 

The  user’s  personalized  notebook  is  a  key  feature  to  the  DMT.  It  allows  the  user 
to  store  important  information  for  further  study.  Extensions  to  the  user’s  interaction 
with  the  notebook  would  greatly  enhance  the  program.  One  extension  might  be  to 
add  an  index  page  to  the  notebook  that  will  list  each  item  included  and  the  page 
number.  Another  extension  will  allow  the  user  to  edit  his  notebook  while  running  the 
DMT  program.  Other  extensions  are  also  possible;  but,  these  two  can  directly 
enhance  the  usability  of  the  notebook  as  a  learning  tool. 
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D.  THE  NEXT  THREE  MODULES 

As  mentioned  in  the  introduction  to  this  chapter,  the  completion  of  the  DMT  User 
Interface  represents  only  25%  of  a  complete  ICAI  system.  The  remaining  75%  of  the 
work  resides  in  the  unimplemented  modules:  the  Expert  System,  the  Tutor  Model  and 
the  Student  Model.  In  this  thesis,  these  tliree  modules  are  referred  to  as  the 
Artificial  Intelligence  (AI)  modules. 

The  User  Interface  is  developed  with  the  Turbo  C  programming  language.  Turbo 
C  has  been  chosen  because  it  is  good  at  manipulating  hardware.  This  is  necessary 
since  the  User  Interface  is  concerned  mainly  with  input/output  from  the  user.  Thus,  a 
language  that  makes  it  easy  to  manipulate  the  input/output  devices  of  the  PC  is 
essential. 

The  remaining  AI  modules  require  a  different  programming  environment  than  the 
User  Interface.  The  AI  modules  do  not  interact  directly  with  the  user.  Thus,  a  good 
hardware  manipulation  language  like  Turbo  C  is  not  required.  Instead,  a  programming 
environment  that  is  suitable  for  implementing  AI  techniques  is  needed.  The  only 
limitation  to  this  environment  is  that  it  must  have  the  capability  to  link  with  Turbo  C 
executable  programs,  i.e.,  the  User  Inteiface.  One  language  that  fits  the  requirement 
is  Turbo  Prolog. 

E.  WORKLOAD 

The  proposed  extensions  and  the  remaining  AI  modules  fit  into  two  basic 
categories:  thesis  work  and  class  projects.  Also,  completion  of  these  extensions 
require  experts  in  many  different  fields  including  computer  science,  discrete  math,  C 
programming  and  psychology.  Figure  25  categorizes  each  project  into  the  amount  of 
work  involved  and  who  should  attempt  it.  Figure  26  is  a  digraph  that  details  the  order 
in  which  each  project  should  be  attempted. 
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Topic 

Project  Type 

Student  Type 

1  Testing/ModiGcation 

Thesis  Topic 

Computer  Science 

2  Automatic  Menu  Generation 

Gass  Project 

C  Programmer 

3  Notebook  Editing 

Gass  Project 

C  Programmer 

4  Mouse  Support 

Gass  Project 

C  Programmer 

5  AT  80386  Upgrade 

Thesis  Topic 

Computer  Science 

6  Discrete  Math  Lessons 

Gass  Project 

Discrete  Math 

7  Expert  System 

Thesis  Topic 

Computer  Science/Discrete  Math 

8  Student  Model 

Tlresis  Topic 

Computer  Science/Psychology 

9  Teaching  Model 

Thesis  Topic 

Computer  Science/Psychology 

Figure  26  -Order  of  Future  Work 
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The  most  difficult  problems  to  solve  are  die  last  three  listed  in  Figure  25:  the  AJ 
modules.  The  AI  modules  are  the  most  difficult  because  they  require  experts  in  two 
completely  different  fields  to  solve  each  problem.  For  example,  the  Expert  System 
module  requires  a  computer  scientist  with  a  background  in  artificial  intelligence 
techniques  and  a  mathematician  with  an  emphasis  in  discrete  math.  Likewise,  the 
Student  Model  and  the  Teaching  Model  both  require  the  same  type  of  computer 
scientist  as  the  Expert  System  module  as  well  as  a  psychologist  with  a  background  in 
learning  theory. 

The  combination  of  computer  science  and  psychology  make  the  Student  Model  and 
the  Teaching  Model  the  most  difficult  of  all.  Both  topics  require  the  cooperation  of 
two  entirely  different  disciplines.  However,  both  are  essential  to  the  successful 
completion  of  the  DMT.  The  computer  scientist  understands  how  the  computer  works 
and  the  psychologist  understands  how  a  student  learns. 

F.  CONCLUSIONS 

The  Discrete  Math  Tutor  (DMT)  is  25%  complete.  The  only  module  implemented 
out  of  the  four  that  make  up  an  Intelligent  Computer  Aided  Instruction  (ICAI)  system 
is  the  User  Interface  module.  However,  this  phase  was  not  insignificant.  The 
finished  User  Interface  contains  8694  lines  of  C  code  and  comments  (See  Appendices 
E-T). 

The  work  was  divided  equally  between  the  two  authors:  Keith  Calcote  and  Rick 
Howard.  Calcote  delivered  the  lesson  program  and  all  the  tools  while  Howard 
designed  and  implemented  the  interface.  However,  both  provided  insight  to  each 
other  when  problems  occurred. 

Two  key  problems  were  solved  in  order  to  make  the  User  Interface  work.  First,  a 
way  to  convert  ASCII  files  into  a  lesson  or  exam  was  essential  to  make  the  DMT 
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useful.  With  this  functionality,  anyone  who  has  access  to  an  ASCII  editor  may  write 
a  lesson  or  exam  that  the  DMT  can  easily  present.  Second,  solving  the  layered 
memory  problem  was  critical  to  the  future  success  of  the  DMT  operating  as  a 
complete  ICAI  system.  Without  the  layered  memory  solution,  the  User  Interface 
would  have  exceeded  the  640K  upper  bound  of  RAM.  Consequently,  there  would  not 
have  been  any  available  memory  left  to  add  the  three  unimplimented  AI  modules. 

Notwithstanding,  the  User  Interface  is  a  useful  product  in  its  own  right.  The 
mixed  initiative  environment  makes  the  DMT  stand  out  compared  to  conventional 
CAI  programs  found  in  the  public  sector.  Allowing  the  student  the  ability  to  pursue 
topics  of  interest  from  any  point  in  a  lesson  provides  a  necessary  measure  of 
student  control.  The  student  does  not  have  to  sit  in  front  of  a  computer  and  read 
endless  screens  of  text.  Instead,  he  can  select  what  he  needs  to  see  and  pursue  the 
answers  to  questions  that  occur  while  the  lesson  is  presented. 

The  DMT  is  a  working  prototype.  On  its  own,  the  DMT  demonstrates  the 
potential  it  has  as  an  effective  ICAI  system.  To  make  the  prototype  complete,  three 
tasks  must  be  accomplished: 

1 .  Test  the  existing  DMT  for  strengths  and  weaknesses 

2.  Modify  the  DMT  based  on  the  test  results  and  known  extensions 

3.  Implement  the  remaining  AI  modules 

However,  the  DMT  as  it  exists  now  is  superior  to  the  standard  CAI  program  and  is 
available  right  now  to  teach  students  certain  aspects  of  discrete  math. 
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APPENDIX  A 


REQUIREMENTS  DOCUMENT 

A.  INTRODUCTION 

The  user  interface  to  an  intelligent  tutor  is  critical  for  any  ICAI  system  and  is  the 
main  focus  for  this  thesis.  This  appendix  describes  the  mechanics  of  how  the 
designers  envision  the  user  interface  for  the  Discrete  Math  Tutor  (DMT).  This 
document  was  used  as  a  basis  to  develop  the  Design  Document  (See  Appendix  B) 
and  all  code  (See  Appendices  E-T). 

B.  ENVIRONMENTAL  CHARACTERISTICS 

1.  Minimum  Hardware  Required 

•  AT  Class  Personal  Computer  with  a  8086  CPU  or  higher. 

•  EGA  graphics  card  or  higher. 

•  Monochrome  monitor  or  higher. 

•  A  dot  matrix  printer  with  draft  quality  or  better. 

•  20  Megabyte  hard  disk  or  greater. 

2.  Target  Audience 

DMT  students  are  assumed  to  be  computer  novices  with  no  prior  experience 
in  Discrete  Math  but  possessing  a  strong  high  school  algebra  foundation. 

C.  OVERVIEW 

The  DMT  interface  provides  the  student  with  the  capability  to  ask  any  reasonable 
question  that  he  may  have  regarding  a  tutorial  lesson.  But,  the  interface  is  not 
required  to  understand  the  natural  human  language.  The  interface  also  provides  a 
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complete  learning  environment.  In  other  words,  when  a  student  sits  down  to  use  the 
DMT,  he  requires  no  other  materials  but  the  minimum  hardware  requirements 
mentioned  in  Section  B 1 . 

The  DMT  is  divided  into  six  sections  of  functionality: 

1.  "Begin"  and  "Quit"  are  self  explanatory 

2.  "Information"  allows  the  user  to  review  important  definitions,  theorems  and 
examples  pertaining  to  a  lesson  of  interest. 

3.  "Pictures"  gives  the  user  the  capability  to  construct  any  type  of  diagram  during 
any  part  of  the  lesson.  For  example,  perhaps  a  student  is  trying  to  solve  a 
Depth  First  Search  problem.  The  DMT  provides  the  student  a  means  to 
construct  the  graph  of  the  problem  he  wishes  to  solve. 

4.  "Algorithms"  allows  the  student  to  see  the  results  of  different  algorithms  on 
data  that  he  provides. 

5.  "Calculator"  provides  the  student  a  means  of  determining  the  answer  to  quick 
numerical  calculations:  addition,  subtraction,  multiplication  and  division. 

6.  "Notebook"  allows  the  student  to  store  key  facts  such  as  definitions,  theorems, 
algoritluns  and  examples  for  future  study. 

D.  STORY-BOARD 
1.  Opening  Screen 

Figure  27  is  the  opening  screen  to  the  DMT. 

The  menu  bar  at  the  top  represents  all  the  options  available  for  this  program. 

The  DMT  highlights  the  "Begin"  portion  of  the  menu  bar  in  a  different  color 
initially  and  moves  the  highlighted  area  to  any  user  selected  option. 

When  one  of  the  above  menu  options  is  selected,  the  DMT  displays  a  pop-up 
menu  that  lists  further  choices. 
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Information  Pictures  Algoritlims  Calculator  Notebook  Quit 


DISCRETE  MATH  TUTOR 


FI  for  Help  ESC  to  Backup 


Figure  27  -Opening  Screen 
2.  "Begin"  Pop-up  Menu 

The  menu  shown  in  Figure  28  is  presented  if  Begin  is  chosen  from  the  top 
menu  bar.  The  DMT  displays  other  pop-up  menus  depending  on  the  choice  made 
here. 
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Figure  28  -"Begin"  Pop-up  Menu 
3.  "Start  a  Lesson"  Pop-up  Menu 

The  menu  shown  in  Figure  29  is  presented  if  Start  a  Lesson  is  chosen  from  the 
"Begin"  Pop-up  menu.  The  user  chooses  the  lesson  he  wishes  to  study.  The 
lessons  listed  here  are  just  examples  and  do  not  reflect  what  will  actually  be  included 
in  the  DMT.  Each  lesson  is  listed  in  the  recommended  sequence  of  study. 
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Start  a  Lesson 

/ntroduction 

Logic 

Graphs 

Figure  29  -"Start  a  Lesson"  Pop-up  Menu 

4.  "Return  to  Last  Session"  Pop-up  Menu 

The  menu  shown  in  Figure  30  is  presented  if  Return  to  Last  Session  is  chosen 
from  the  "Begin"  Pop-up  menu.  The  user  enters  his  social  security  number.  The  DMT 
then  displays  the  user’s  last  screen  in  his  previous  session. 


Return  to  Last  Session 


Enter  Your  Social  Security  Number: 


Figure  30  -"Return  to  Last  Session"  Pop-up  Menu 
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5.  "Information"  Pop-up  Menu 

The  menu  shown  in  Figure  31  is  presented  if  Information  is  chosen  from  the 
top  menu  bar. 

When  one  of  the  options  is  selected,  the  DMT  displays  a  pop-up  menu  that 
lists  further  choices. 


/nformation 

Definitions 

Examples 

Theorems 

Figure  31  -"Information"  Pop-up  Menu 
6.  "Definitions"  Pop-up  Menu 

The  menu  shown  in  Figure  32  is  presented  if  Definitions  is  chosen  from  the 
"Information"  Pop-up  menu.  It  lists  the  names  of  all  definitions  in  the  DMT  by  name 
in  alphabetical  order.  After  the  user  chooses  the  definition  he  wishes  to  review,  the 
DMT  displays  the  entire  definition  in  a  pop-up  window.  The  DMT  then  presents  the 
options  shown  in  Figure  33. 
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Definitions 
Definition  1 
Definition  2 
Definition  3 
Definition  4 


Notebook  Interaction _ 

Add  Definition  to  Notebook 
Print  Definition 

Figure  33  -"Notebook  Interaction"  Pop-up  Menu 
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If  die  user  chooses  "Add  Definition  to  Notebook",  the  DMT  concatenates  the 
entire  definition  to  the  end  of  the  student’s  notebook  . 

If  the  user  chooses  "Print  Definition",  the  DMT  outputs  the  definition  to  the 

printer. 


7.  "Examples"  Pop-up  Menu 

The  menu  shown  in  Figure  34  is  presented  if  Examples  is  chosen  from  the 
"Information"  Pop-up  menu.  It  lists  the  names  of  all  examples  in  the  DMT  by  name 
hi  alphabetical  order.  After  the  user  chooses  the  example  he  wishes  to  review,  the 
DMT  displays  the  entire  example  in  a  pop-up  window. 


Choose  an  Example 


Example  1 
Example  2 


Example  3 


Example  4 


Figure  34  -"Choose  an  Examples"  Pop-up  Menu 
The  DMT  then  presents  the  menu  shown  in  Figure  35. 

If  the  user  chooses  "Add  Example  to  Notebook",  the  DMT  concatenates  the 
entire  example  to  the  end  of  the  user’s  notebook. 
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If  the  user  chooses  "Print  the  Example",  the  DMT  outputs  the  example  to  the 


printer. 


— 1 

Examples 

Add  Example  to  Notebook 

Flint  the  Example 

1 _ 

Figure  35  -Examples 
8.  "Theorems"  Pop-up  Menu 

The  menu  shown  in  Figure  36  is  presented  if  Theorems  is  chosen  from  the 
"Information"  Pop-up  menu.  It  lists  the  names  of  all  theorems  in  the  DMT  by  name  in 
alphabetical  order.  After  the  user  chooses  the  theorem  he  wishes  to  review,  the 
DMT  displays  the  entire  theorem  in  a  pop-up  window.  The  DMT  then  presents 
options  shown  in  Figure  37. 
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Theorems 


Theorem  1 
Theorem  2 
Theorem  3 
Theorem  4 


Figure  36  -"Theorems"  Pop-up  Menu 


Notebook  Interaction 

Add  Theorem  to  Notebook 

Print  Theorem 

Figure  37  -"Notebook  Interaction"  Pop-up  Menu 
If  the  user  chooses  "Acid  Theorem  to  Notebook",  the  entire  theorem  is 
concatenated  to  the  end  of  the  user’s  notebook. 

If  die  user  chooses  "Print  Theorem",  the  DMT  outputs  the  theorem  to  the 

printer. 
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9.  "Pictures"  Pop-up  Menu 

The  menu  shown  in  Figure  38  is  presented  if  Pictures  is  chosen  rrom  the  top 
menu  bar.  Choosing  an  option  from  this  menu  allows  the  user  to  draw  a  picture  in  a 
pop-up  window.  The  Truth  Table  and  the  Graph  are  just  examples.  It  is  not  known 
what  kind  of  pictures  are  required.  This  determination  will  depend  upon  how  the 
authors  of  any  particular  lesson  construct  their  lesson  plan.  However,  if  a  picture  of 
some  sort  is  required  in  any  lesson,  the  DMT  will  provide  the  user  the  drawing 
capability  from  this  menu  selection. 


Pictures 

Truth  Table 

Graph 

Add  to  Notebook 

Print  Picture 

1 

Figure  38  -  "Pictures"  Pop-up  Menu 
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10.  "Algorithm"  Pop-up  Menu 

The  menu  shown  in  Figure  39  is  presented  if  Algorithm  is  chosen  from  the  top 
menu  bar.  It  lists  the  names  of  all  algorithms  in  the  DMT  by  name  in  alphabetical 
order.  After  the  user  chooses  the  algorithm  he  wishes  to  review,  the  DMT  presents 
the  options  shown  in  Figure  40. 


Choose  an  Algorithm 

Algorithm  1 

Algorithm  2 

Algorithm  3 

Algorithm  4 

Figure  39  -"Choose  an  Algorithm"  Pop-up  Menu 
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Algorithm 

List  the  Algorithm 

Step  thru  the  Algorithm 

Run  the  Algorithm 

Add  Algorithm  to  Notebook 

Print  the  Algorithm 

Figure  40  -"Algorithm"  Pop-up  Menu 

If  the  user  chooses  "List  the  Algorithm",  the  DMT  displays  a  description  of 
the  algorithm  in  a  pop-up  window. 

If  the  user  chooses  "Step  thru  the  Algorithm",  the  DMT  walks  the  user  thru 
the  chosen  algoritlun  one  step  at  a  time  in  a  pop-up  window  on  data  that  the  user 
provides. 

If  the  user  chooses  "Run  the  Algoritlun",  the  DMT  displays  the  answer  to  a 
set  of  user  provided  data  in  a  pop-up  window  using  the  chosen  algorithm. 

If  the  user  chooses  "Add  Algorithm  to  Notebook",  the  DMT  concatenates  the 
entire  algorithm  to  the  end  of  the  user’s  notebook. 

If  the  user  chooses  "Print  the  Algorithm",  the  DMT  outputs  the  algorithm  to 
the  printer. 
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11.  "Calculator"  Pop-up  Window 

The  pop-up  window  shown  in  Figure  41  is  presented  if  Calculator  is  chosen 
from  the  top  menu  bar.  The  user  enters  calculations  into  the  calculator  in  "INFIX" 
notation  straight  from  the  keyboard.  For  example,  if  the  user  wishes  the  results  of 
the  addition  2+2,  he  enters  the  following  data: 

2+2= 

The  DMT  shows  the  "2+2"  in  the  display  portion  of  the  calculator.  When  the 
user  pushes  the  DMT  clears  the  display  and  presents  the  answer. 


Figure  41  -"Calculator”  Pop-up  Window 
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12."  Notebook"  Pop-up  Menu 

The  menu  shown  in  Figure  42  is  presented  if  Notebook  is  chosen  from  the  top 
menu  bar. 

If  the  user  chooses  "View  Notebook",  the  DMT  displays  a  pop-up  window 
with  the  contents  of  the  user’s  personal  notebook.  The  DMT  allows  the  user  to  page 
up  and  down  his  notebook.  The  user  presses  the  escape  key  to  return  to  his  previous 
window. 

If  the  user  chooses  "Print  Notebook",  the  DMT  sends  the  contents  of  the 
user’s  personal  notebook  to  the  printer. 


Notebook 

View  Notebook 

Print  Notebook 

Figure  42  -"Notebook"  Pop-up  Menu 
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13.  "Quit"  Pop-up  Menu 

The  menu  shown  in  Figure  43  is  presented  if  Quit  is  chosen  from  the  top  menu 
bar. 

If  the  user  chooses  "Save  Current  Position",  the  DMT  presents  the  same 
display  as  presented  in  Section  3D:  Return  to  Last  Lesson.  After  the  user  enters  the 
correct  SSN,  the  DMT  returns  the  user  to  the  "Quit"  pop-up  menu.  If  the  user  used 
"Return  to  Last  Session"  upon  the  start  of  this  session,  the  DMT  will  not  make  the 
user  enter  the  SSN  again.  It  will  remember  the  current  SSN  and  store  the  current 
lesson  session  position  under  that  SSN.  This  functionality  allows  the  user  to  return 
to  his  last  location  in  the  DMT  when  he  returns. 

If  the  user  chooses  "Display  Results",  the  DMT  will  display  the  student’s 
performance  in  a  pop-up  window.  The  "Display  Result"  screen  is  not  yet  determined 
since  the  student  model  has  not  been  designed. 

If  the  user  chooses  "Exit",  the  program  tenninates. 


I  1 

Quit 

Save  Current  Position 

Display  Results 

Exit 

Figure  43  -"Quit"  Pop-up  Menu 
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14.  "Help"  Pop>up  Menu 


Help  is  not  a  selection  from  the  top  menu  bar.  However,  it  is  constantly 
available  to  the  user  if  he  presses  the  FI  key.  Help  presented  to  the  user  is  context 
sensitive.  This  means  that  the  DMT  will  present  an  appropriate  help  screen  no 
matter  where  the  user  is  in  the  system. 

15.  General  Notes 

On  any  pop-up  menu,  die  DMT  will  not  accept  keystrokes  that  are  not  valid 
choices. 

All  pop-up  menus  stay  on  the  screen  until  a  choice  is  made.  An  example  is 
shown  in  Figure  44. 
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Information  Pictures  Algorithms  Calculator  Notebook  Quit 


Begin 


Return  to  Last  Lesson 


Start  a  Certain  Lesson 


Introduction 


Logic 


Graphs 


Bibliography 


Figure  44  -Cascading  Menu  Example 

The  user  chose  the  "Begin"  pop-up  menu.  The  DMT  offeres  two  choices: 
Start  a  Lesson  and  Return  to  Last  Session.  Suppose  the  user  chose  Start  a  Lesson. 
The  DMT  then  displays  the  "Start  a  Lesson"  pop-up  menu. 

After  the  user  chooses  which  lesson  he  wants,  the  DMT  erases  the  pop-up 
menus  and  starts  the  chosen  lesson. 

The  user  chooses  menu  items  in  one  of  three  ways:  arrow  keys  and  a  carriage 
return,  key  letters  in  the  menu  choice  (indicated  by  italicized  first  letters  in  all 
menus),  or  the  point  and  shoot  mouse. 
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The  escape  key  allows  the  user  to  return  to  the  previous  window  or  pop-up 
menu  at  any  time. 

E.  CONSTRAINTS  &  GOALS 

1.  Constraints 

Lesson  authors  must  write  lessons  with  the  DMT  interface  in  mind.  After  a 
lesson  is  developed,  the  author  must  prepare  the  following  additional  screens: 
definition,  algorithm,  theorem,  and  example. 

Any  diagrams  needed  in  the  lesson  must  be  provided  in  the  "Pictures"  portion 
of  the  DMT. 

Any  new  calculator  functions  needed  by  the  students  must  be  added  to  the 
"Calculator"  portion  of  the  DMT. 

2.  Goals 

The  interface  allows  the  user  to  ask  any  pertinent  question  about  the  lesson 
without  having  the  computer  act  as  a  language  interpreter. 

The  DMT  is  an  evolving  system.  As  new  lessons  are  added,  new 
functionality  to  the  DMT  interface  must  be  added. 

The  DMT  Interface  is  an  overlay  to  any  math  tutor  system.  In  other  words, 
the  DMT  interface  could  be  laid  on  top  of  any  existing  math  tutor  as  long  as  the 
constraints  mentioned  above  were  met.  Tliis  means  that  the  DMT  interface  could 
become  a  standard  for  any  math  tutor. 

F.  LIFE  CYCLE  CONSIDERATIONS 

The  desired  DMT  should  function  as  described. 

If  problems  occur  in  the  design  and  implementation  phase  of  this  project,  the 
following  reduced  DMT  functionality  will  be  implemented: 


65 


•  The  "Algorithm"  portion  of  the  DMT  will  only  run  algorithms  and  not  allow 
die  user  to  step  thru  an  algorithm. 

•  The  "Notebook"  portion  of  the  DMT  will  not  allow  the  user  to  page  up  and 
down  the  contents  of  the  notebook.  Instead  it  will  allow  the  user  to  scroll 
one  way  through  the  notebook. 

If  no  problems  occur  during  the  design  and  implementation  phase  of  this  project, 
the  following  functionality  will  be  added  to  the  DMT: 

•  Add  pages  to  the  student  notebook  so  that  all  entries  can  be  indexed. 

•  Allow  the  user  to  selectively  erase  portions  of  the  notebook. 
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APPENDIX  B 


DESIGN  DOCUMENT 

A.  INTRODUCTION 

The  user  interface  to  an  intelligent  tutor  is  critical  for  any  ICAI  system  and  is  the 
main  focus  for  this  thesis.  This  appendix  describes  the  design  of  the  user  interface 
for  the  Discrete  Math  Tutor  (DMT)  using  the  Software  Design  methodology.  This 
document  was  completed  after  the  Requirements  Document  (See  Appendix  A)  and 
prior  to  any  written  code  (See  Appendices  E-T). 


B.  SOFTWARE  DESIGN  METHODOLOGY  (SWD) 


The  major  component  to  SWD  is  the  Data  Flow  Diagram  or  DFD.  The  DFD  is 
used  to  model  any  type  of  system.  SWD  uses  only  four  symbols  to  describe  a  DFD: 


1 .  External  Entity  CD 

2.  Data  Flow  . 

3.  Process  ^  ‘ 

4.  Data  Store  — ~  ■< 


->  The  source/destination  of  data  outside  the  system. 
->  A  path  that  data  follows. 

->  A  function  that  transforms  data. 

->  A  place  to  store  data. 


From  the  DFD,  die  Data  Dictionary  is  derived.  The  Data  Dictionary  represents 
an  abstract  view  of  the  type  of  information  inside  the  system.  (Gane,  1978) 
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C.  SWD  APPLIED  TO  THE  USER  INTERFACE 
1.  The  DFD 

SWD  is  a  hierarchical  procedure.  The  designer  begins  with  the  "Big  Picture" 
abstract  view  of  his  application  and  uses  a  DFD  to  describe  it. 

Figure  45  is  a  simple,  abstract  view  of  the  Discrete  Math  Tutor  (DMT).  Note 
that  the  user  is  an  outside  entity  to  the  DMT.  He  provides  "Input"  data  and 
"Problems"  data  to  it.  He  receives  "Solutions"  data  and  "Lessons"  data  from  it. 
These  data  items  become  the  first  entries  listed  in  the  DMT  Data  Dictionary. 

More  detail  to  this  level  of  abstraction  is  added  by  developing  a  DFD  for  each 
"Process"  described.  For  example,  a  DFD  for  the  DMT  process  is  shown  in  Figure  2. 


Figure  45  -SWD  Top  Level  abstraction  of  the  Discrete  Math  Tutor  (DMT) 
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Figure  46  -DFD  for  the  DMT  Process 

In  Figure  46,  the  four  basic  modules  described  in  the  thesis  introduction 
appear  for  the  first  time.  A  new  entry  into  the  Data  Dictionary  includes  the 
"Performance"  data  item. 

Further  detail  is  now  added  to  this  level  of  abstraction  by  following  the  same 
procedure.  Since  this  thesis  deals  with  the  user  interface,  the  next  abstraction  level 
concerns  the  DFD  for  the  User  Interface  process  and  is  shown  in  Figure  3. 

Notice  that  in  Figure  47,  the  Tutor  Module,  Expert  Module,  Student  Module 
and  User  are  all  external  entities  to  the  Interface  Processing  System;  however,  the 
Information  Processing  System  receives  the  same  data  items  described  in  Figure  46. 
Further,  Figure  47  shows  the  Data  Store  symbol  for  the  first  time.  These  Data 
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Stores  hold  information  in  the  form  of  Text  for  use  by  the  Interface  Processing 
System.  Thus,  the  Data  Dictionary  must  now  include  Text  as  a  Data  Item. 
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Observe  that  all  the  data  stores  and  processes  mentioned  in  the  previous 
examples  are  shown  as  outside  entities  in  this  DFD  shown  in  Figure  48.  Further 
notice  that  all  the  processes  listed  in  the  DFD  shown  in  Figure  48  represent  the  main 
functionality  of  the  user  interface. 

The  command  center  controls  all  the  operations  in  the  Interface  Processing 
System.  Based  on  input  from  the  User,  the  Command  Center  contacts  the  other 
entities  in  the  DMT.  For  example,  die  user  may  wish  to  see  a  Theorem,  Definition  or 
a  Notebook  entry.  The  Command  Center  retrieves  that  information  from  the 
appropriate  data  store  and  presents  it  to  the  user. 

The  Calculator  process  and  the  Pictures  process  are  programs  within  the 
program.  This  means  that  once  the  Command  Center  starts  these  processes,  they 
perform  their  functions  based  solely  on  the  User  input  and  not  from  any  commands 
from  the  Command  Center.  Once  the  user  terminates  these  two  processes,  the 
program  passes  control  back  to  die  Command  Center. 

The  Calculator  process  perfonns  simple  calculations  pertaining  to  any  Discrete 
Math  lesson  and  the  Pictures  process  allows  the  user  to  represent  Discrete  Math 
problems  in  a  graphical  form. 

The  Show  Example  and  Show  Algorithm  processes  step  the  user  through 
desired  problem  examples  and  Discrete  Math  algorithms  based  on  the  user's  choice. 
These  processes  are  different  from  simply  showing  the  user  a  definition  or  a  theorem 
in  that  the  program  presents  each  example  and  algoritlim  like  a  lesson. 

Finally,  the  Make  Menus  process  constructs  the  menuing  system  that  allows 
the  User  to  make  his  choices  from  the  Command  Center. 

Now  the  Data  Dictionary  contains  three  additional  items:  Example  Choice, 
Algorithm  Choice  and  Start.  The  Example  and  Algorithm  Choice  options  are  self- 
explanatory;  but.  Start  needs  some  explanation. 
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When  a  process  receives  the  Start  Data  Item,  it  begins  its  process.  The 
process  executes  based  solely  on  internal  data  structures.  It  does  not  rely  on  any 
outside  Data  Stores  mentioned  in  the  higher  levels  of  abstraction.  As  mentioned  for 
the  Calculator  and  Pictures  processes,  when  the  running  process  is  complete,  it 
returns  control  back  to  the  Command  Center. 

2.  The  Data  Dictionary 

From  the  above  Data  Flow  Diagrams,  the  Data  Dictionaty  contains  the  Data 
Items  listed  in  Figure  49: 


Problems 

Solutions 

Lessons 

Performance 

Text 

Input 

Example  Choice 
Start 

Algorithm  Choice 


Figure  49  -  Data  Dictionary  Entries 

The  designation  assigned  to  each  data  item  is  a  high  level  abstraction  of  what 
is  actually  represented  in  the  program.  More  detail  is  provided  by  subdividing  each 
data  item  into  its  atomic  levels.  For  example,  the  "Lessons"  Data  Dictionary  entry 
may  divide  into  two  parts:  "Text"  and  "Pictures". 

The  following  description  of  the  Data  Dictionary  for  the  DMT  is  based  on  one 
lesson:  Logic.  Obviously,  the  DMT  will  contain  more  sub-divisions  of  Data  Items  as 
more  lessons  are  added. 
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The  following  figures  show  each  entry  in  the  Data  Dictionary  subdivided  into 
its  atomic  level.  For  example,  Figure  50  shows  that  the  "Problems"  data  item  is 
subdivided  into  a  "Logic  Equation".  Figure  50  also  shows  what  a  "Logic  Equation" 
looks  like.  Figure  51  shows  how  the  "Solutions"  data  item  is  subdivided.  Figures  52, 
53  and  54  show  how  the  "Lessons"  data  item  is  subdivided.  Figures  55  and  56  show 
how  the  "Performance"  data  item  is  subdivided.  Figures  57,  58,  59,  60  and  61  show 
how  die  "Text"  data  item  is  subdivided.  Figure  62  shows  how  the  "Input",  "Example 
Choice"  and  "Algorithm  Choice"  data  items  are  subdivided.  Figure  63  shows  how  the 
"Start"  data  item  is  subdivided. 


Problems  ->  Logic  Equation 

(p=>q)  V  (q=>p) 


Figure  50  -Problems  Data  Item 
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Solutions  ->  Truth  Table 


p 

<7 

II 

V 

*c> 

II 

V 

(p=>q)  V  (q->p) 

T 

T 

T 

T 

T 

T 

F 

F 

T 

T 

F 

T 

T 

F 

T 

F 

F 

T 

T 

T 

Figure  51  -Solutions  Data  Item 


Lessons  ->  Text 

This  is  the  Truth  Table  for  the  equation: 
(p=>q)  V  ( q=>p ) 


Figure  52  -  Lessons  Data  Item  (Text) 
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Lessons  ->  Pictures 


Lessons  ->  Pictures  ->  Text 


This  is  a  tautology 


Figure  54  -  Lessons  Data  Item  (Pictures  ->  Text) 
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Performance  ->  Score 

Logic: 

Truth  Tables 
65% 

Figure  55  -  Performance  Data  Item  (Score) 

Performance  ->  Score  ->  Text 

Student  Smith’s  Performance: 

Recommend  more  study  in  the  area  of  Truth  Tables 

Figure  56  -  Performance  Data  Item  (Score  ->  Text) 

Text  ->  Definitions 

Tautology: 

A  sentence,  F,  is  said  to  be  valid  for  all  interpretations 

Figure  57  •  Text  Data  Item  (Definitions) 
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Text  ->  Examples 

Construct  a  Truth  Table  by  first  identifying  each 
element  in  the  equation;  in  this  case  p  &  q. 

Figure  58  -  Text  Data  Item  (Examples) 

Text  ->  Algorithm 

Step  1: 

Identify  the  atomic  elements  in  the 
desired  logic  equation... 

Figure  59  -  Text  Data  Item  (Algorithm) 

Text  ->  Theorems 

(F  =>  Gj  <=>  -(  (F)  A  (~G)  ) 

Figure  60  -  Text  Data  Item  (Theorems) 
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Text  ->  Notebook 

Any  Text  Data  Item  from  above 

Figure  61  -  Text  Data  item  (Notebook) 

Input/Example  Choice/Algorithm  Choice  -> 

Menu  Selection 

See  the  Requirements  Document 

Figure  62  -  Input/Example  Choice/  Algorithm  Choice  (Menu  Selection) 

Start  -> 

A  signal  to  begin 

Figure  63  -  Start  Data  Item 
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APPENDIX  C 


HOT  KEY  SUMMARY 


A.  BEGIN 

1 .  Begin  is  invoked  by  typing  the  letter  B . 

2.  The  Begin  menu  provides  two  options  begin  a  iesson,  Start  a  lesson  from  the 
first  page  in  the  lesson,  or  Return  to  the  last  active  page  of  a  previous  lesson. 

B.  ESCAPE 

1 .  Escape  is  invoked  by  typing  the  Esc  key. 

2.  Esc  key  is  accessible  throughout  the  tutor  to  back  out  of  menus. 

C.  EXAMS 

1 .  Exams  is  selected  from  the  main  menu  by  typing  the  hot  key,  E. 

2.  A  particular  exam  may  be  chosen  by  moving  the  cursor  to  the  name  of  the 
exam  in  the  list  and  pressing  the  enter  key. 

D.  HELP 

1 .  Help  is  invoked  by  typing  the  letter  H. 

2.  With  the  exception  of  the  Esc  key,  the  operation  of  all  hot  keys  is  suspended 
while  help  is  active. 

3.  The  help  screen  describes  the  hot  keys. 

4.  Typing  the  Esc  key  will  exit  the  help  screen. 

5.  Typing  the  Esc  key  twice  while  the  help  screen  is  active  will  exit  the  Tutor  and 
return  the  user  to  the  operating  system. 
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E.  INFORMATION 

1.  Information  is  invoked  from  the  main  menu  by  typing  the  letter  I. 

2.  Definitions,  examples,  theorems,  and  proofs  are  selectable  from  the 
information  menu. 

3.  The  selected  material  may  be  added  to  the  user’s  notebook  or  may  be  directed 
to  the  printer  for  hard  copy. 

F.  NOTEBOOK 

1 .  Notebook  is  selected  from  the  main  menu  by  typing  the  letter  N. 

2.  The  notebook  may  be  displayed  or  printed. 

G.  TOOLS 

1 .  Tools,  is  selected  from  the  main  menu  by  typing  the  hot  key  T. 

2.  Diagrams,  Reference,  Calculator,  or  Problem  Solver  are  available  in  the  tools 
menu. 

H.  QUIT 

1 .  Quit  is  selected  from  the  main  menu  by  typing  the  letter  Q. 

2.  Save  the  current  position  and  exit  may  be  selected  from  the  quit  menu 
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APPENDIX  D 


INSTALLATION  PROCEDURES 

The  following  files  must  reside  in  the  same  directory  for  the  DMT  to  execute  prop¬ 
erly: 

GOTH.CHR 

LITT.CHR 

SANS.CHR 

TR1D.CHR 

EXPL.TXT 

EXPL1.TXT 

LENGTH.TXT 

LOGIC.TXT 

LOGICORG.TXT 

LOGlCSET.TXT 

ATT.BGI 

CGA.BGI 

EGAVGA.BGI 

HERC.BGI 

IBM8514.BGI 

PC3270.BGI 

GRAPH.  DEF 

NOTHING. DEF 

DMT.HLP 

CALC.EXE 

FREE.EXE 


82 


DMT.  EXE 

LSN.EXE 

FLASII.EXE 

PRINT.EXE 

EXAM.EXE 

RULES.EXE 

TABLE.EXE 

TXTMOD.EXE 

VENN.EXE 


VENNINFO.EXE 


APPENDIX  E 


THE  CODE:  FILE  "DMT.C" 


^* ******************************************************************%*** 


The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 


atoi 

Turbo  C  Lib 

chgonkey 

CXL  Lib 

enor_exit 

DMT  Utilities 

eror_open_file 

DMT  Utilities 

exit 

DMT  Utilities 

findfirst 

Turbo  C  Lib 

introduction_bar 

DMT  Utilities 

interface_bar 

DMT  Utilities 

hidecur 

CXL  Lib 

normal_exit 

DMT  Utilities 

setkbloop 

CXL  Lib 

setonkey 

CXL  Lib 

set_video 

DMT  Utilities 

spawnl 

Turbo  C  Lib 

strbtrim 

CXL  Lib 

top_bar 

DMT  Utilities 

videoinit 

CXL  Lib 

waitkey 

CXL  Lib 

wcenters 

CXL  Lib 

wclose 

CXL  Lib 

wfillch 

CXL  Lib 

wgetchf 

CXL  Lib 

whelpcat 

CXL  Lib 

whelpdef 

CXL  Lib 

whelpopc 

CXL  Lib 

whelpushc 

CXL  Lib 

winpbeg 

CXL  Lib 

winpdef 

CXL  Lib 

winpread 

CXL  Lib 

winputsf 

CXL  Lib 
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LIBRARY  CALLS  (CONTINUED): 


wmenubeg 

CXL  Lib 

wmenuend 

CXL  Lib 

wmenuget 

CXL  Lib 

wmenuitein 

CXL  Lib 

wmenuinext 

CXL  Lib 

wopen 

CXL  Lib 

wpickstr 

CXL  Lib 

wprintf 

CXL  Lib 

wpruits 

CXL  Lib 

wputs 

CXL  Lib 

wrjusts 

CXL  Lib 

wtextattr 

CXL  Lib 

wtitle 

CXL  Lib 

PROGRAM  CALLS: 

calc.exe 

exam.exe 

flash.exe 

lsn.exe 

print.exe 

rules.exe 

table.exe 

textmod.exe 

venn.exe 

venninfo.exe 

DMT  FUNCTIONS: 

main 

initialize 

calculator 

flash_cards 

exams 

line_inp_demo 

logic_exam 

main_menu 

menudemo 

notebook 

open_back_wind 

open_titl_wind 

parse_cmdjine 

pick_algorithm 

pre_menu  1 
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DMT  FUNCTIONS  (CONTINUED): 
print_notebook 
quitjmenu 
ioi  les 
set_video 
table 
tools 
venn 
venn  info 
view_notebook 

COMPLETED:  4/12/90 

PERSONS:  Keith  Calcote  &  Rick  Howard 

PURPOSE:  To  develop  the  user  interface  module  of  a  Dicrete  Math  Intelligent 
tutoring  system  that  runs  on  a  IBM  PC  or  compatable. 

*********************#************************************************/ 

/*  header  files  */ 

#include  <d:\tc\includeVonio.h> 

#include  <d:\tc\incl*.de\ctype.h> 

#include  <d:\tc\includeVlos.h> 

#include  <d:\tc\include\stdio.h> 

#include  <d:Ntc\includeNstdlib.h> 

#include  <d:\tc\include\string.h> 

#include  <d:N'tc\include\process.h> 

#include  <d:^tc\includeVlir.h> 

#include  <d:\tc\include\alloc.h> 

#include  "d:VxLcxldef.h" 

#include  "d:\cxbcxlkey.h" 

#include  ”d :\cxbcxlmou .h" 

#include  "d:\cxPcxlstr.h” 

#include  "d:\cxbcxlvid.h" 

#include  "d:\cxIScxIwin.h" 

#include  "d:\tc\thesisNglobals.h" 

#include  "d^c^hesis^Iefs.h" 

#include  "d:\tc\thesis\help.h" 

#include  "d:\tc\lhesis\util.h" 

#include  "d^cNthesisMink.c" 

#include  "d:Mc\thesis\video.h" 
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/*  function  prototypes  */ 

static  void  initialize  (void); 
static  void  calculator(void); 
static  void  f1ash_cards(void); 
static  void  exams(void); 
static  void  line_inp_demo  (void); 
static  void  logic_exam(void); 
static  void  main_menu  (void); 
static  void  menudemo(void); 
static  void  notebook(void); 
static  void  open_back_wind(void); 
static  void  open_titl_wind(void); 

static  void  parse_cmd_line(int  argc,char  *argv[],  int  *start_up); 

static  void  pick_algoritlim(void); 

static  void  pre_menu  1  (void); 

static  void  print_notebook(void); 

static  void  quit_menu(void); 

static  void  rules(void); 

static  void  set_video(void); 

static  void  table(void); 

static  void  lools(void); 

static  void  venn(void); 

static  void  venninfo(void); 

static  void  view  notebook(void); 
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/I********************************************************************** 


FUNCTION  :  main 


CALLED  BY:  NONE 


CALLS 

MODIFIED 

PERSON 

PURPOSE 


:  See  Declarations 
:  4/12/90 
:  Rick  Howard 
:  See  Declarations 


**********************************************************************/ 


void  main(int  argc.char  *argv[]) 

I 

/* 

Initialize  the  CXL  video  system,  define  hot  keys  and 
define  the  system’s  help  screen  attributes. 

*/ 

initialize(); 


/* 

Process  the  command  line  arguments. 

*/ 

parse_cmd_line(argc,argv,&start_up); 

/* 

If  this  is  the  initialial  start  of  the  program, 
display  the  title  screen. 

*/ 

if  (start_up){ 

openback_wind(); 
set_video(); 
open_titl_wind( ) ; 
introduction_bar(); 

main_menu(); 


/*  Background  to  Title  Screen  */ 

/*  Check  for  mono,  CGA  or  EGA  screen  */ 
/*  Display  the  title  */ 

/*  Display  help  bar  */ 

/*  Display  the  main  menu  */ 


normal_exit();  /*  Terminate  the  program  */ 
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FUNCTION  :  initialize 

CALLED  BY:  dmt 

CALLS  :  videoinit 
setonkey 
whelpdef 

MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Initializes  CXL’s  video  system,  defines  all  hot  keys  and  the 
die  attributes  for  all  help  screens. 

static  void  initialize(void) 

I 

/* 

Initialize  the  CXL  video  system. 

*/ 

videoinitf); 

/* 

Define  all  hot  keys. 

*/ 

setonkey(0x3062,beginjsn,0); 
setonkey  (Ox  1 265 , exams  ,0); 
setonkey(0xl769,information,0); 
setonkey(0x  1 474,tools,0); 
setonkey(0x3 16E, notebook, 0); 
setonkey(0xl07 1  ,quit_menu,0); 
setonkey  (0x2  D78  ,confinn_qu  it  ,0 ); 
setonkey  (0x3 26D,  memory  ,0); 


/*  B  */ 
/*  E  */ 
1*1*1 
I*  T  */ 
/*  N  */ 
/*  Q  */ 
/*X  */ 
I*  M  */ 


I 


I* 

Define  the  help  screen  attributes. 

*/ 

whelpdef(  "DMT.  H  LP"  ,0x2368 ,B  LACKI_LGREY  ,B  LACKI_LGR  EY , 

LBLUEI_LGREY,LREDI_LGREY,pre_help); 
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CALLS  :  spawnl 
MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 


PURPOSE  :  Suspends  the  DMT  interface  program  and  calls  the  calc.exe 
program 

*j|<j(<j|<************%*!|<!|(l|l*l(<**!|<*****!(<**lt<*!(<!!«%***  +  #*l(<!(<***#***l|!*l|<***l|t:(t!|<>|<***:|tl!<!!y 

static  void  calculator! void) 

( 

spawnl(PJVAIT,"calc.exe", "calc.exe", NULL); 

/* 

Returns  the  user  to  the  interface  if  he  is  not  inside  a  lesson; 
otherwise,  returns  the  user  to  the  lesson. 

*/ 

if  (Ifromjsn) 
menudemoO; 
else 
exit(0); 
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FUNCTION  :  flash_cards 
CALLED  BY:  tools 
CALLS  :  spawnl 
MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Suspends  the  DMT  interface  program  and  calls  the  flash.exe 
program 

/**********************:|<:|(*]|<*****!|c***:(c***!'':tt*:tt]|<*i((i(<**itt*s|(!|(*lt'>|c***i|c*s|<****]|<)|<** 

static  void  flash_cards(void) 

I 

spawnl(P_W AIT, "flash.exe","flash.exe", NULL); 

/* 

Returns  the  user  to  the  interface  if  he  is  not  inside  a  lesson; 
otherwise,  returns  the  user  to  the  lesson. 

*/ 

if  (!from_Isn) 

menudemoO; 

else 

exit(0); 
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/a********************************************************************* 


FUNCTION  :  exams 


CALLED  BY:  Hot  key  defined  in  function  initialize 

CALLS  :  wmenubeg 
wmenuitem 
wmenuend 
wmenuget 
error_exit 

MODIFIED  :  4/12/90 

PERSON  :  Rick  Howard 

PURPOSE  :  Defines  the  Exam  menu  and  presents  die  menu  to  the  user 

static  void  exams(void) 

( 

int  selection; 

wmenubeg(2.3 1 ,4,42,0,YELLOWI_BLUE,YELLOWI_BLUE,add_shadow); 
wmenuitem(0.0,"Logic  Exam",’L’,10,0,logic_exam,0,H_EXAMS); 
wmenuend(  1 0  ,M_PDIM_S  AVE,0, 1  ,YELLOWl_B  LUE,LCY  ANI_BLUE,0 

,Y  ELLO  WI_LGREY ); 


se  lect  ion=wmenuget( ) ; 

if(selection==-l&&_winfo.ermo>W_ESCPRESS)  error_exit(  1 ); 

I 
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/ft********************************************************************* 


FUNCTION  :  logic_exam 

CALLED  BY :  exams 

CALLS  :  chgoiikey 
wopen 
error_exit 
add_shadow 
wtitle 
winpbeg 
wprints 
windef 
winpread 
atoi 
wputs 
wgetchf 
wclose 
spawnl 
exit 

MODIFIED  :  4/12/90 

PERSON  :  Rick  Howard 

PURPOSE  :  Allows  user  to  take  the  logic  exam  by  first  asking  how  many 
questions  he  desires.  Then  it  suspends  the  DMT  program 
while  the  Q_&_A.exe  program  executes. 

static  void  logic_exam(void) 

I 

struct  _onkey_t  *kl;  /*  Linked  list  of  hot  keys  */ 

char  *num_questions;  /*  #  of  exam  questions  the  user  desires  */ 
register  int  response;  /*  Records  the  user’s  response  */ 

/* 

Assign  the  current  hot  key  list  to  kl  and  set  the  current  hot 
key  list  to  NULL. 

*/ 

kl  =  chgonkey(NULL); 
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/* 

Open  a  window  to  retrieve  the  desired  number  of  exam  questions 
from  tite  user. 

V 

if(!wopen(10.8,17,70,l,LCYANI_BLUE,  LCYANI_BLUE))  error_exit(l); 
add_shadow(); 

wtitle("(Enter  the  Number  of  Exam  Questions  Desired] ”,TLEFT,  LCYANI_BLUE); 
/* 

Open  window  to  ask  how  many  exam  questions  the  user  desires. 

*/ 

do{ 

/* 

Define  the  window  attributes. 

*/ 

winpbeg(LGREENIJLGREY,WHITEI_LGREY); 

/* 

Display  prompts  and  define  fields. 

*/ 

wprints(  1,  3,  WHITEI_BLUE,  "How  many  exam  questions  do  you  wish?"); 
winpdefi  1, 41,  num_questions,  "##" ,0,0, NULL, 0); 

I* 

Mark  end  of  form  and  process  it. 

*/ 

if(winpread(»  break; 

/* 

Verify  user’s  answer. 

*/ 

if  (!wopen(l5,24,19,57,0,WHITEI_CYAN,WHITEI_CYAN))  error_exit(l ); 
add_shadow(); 

wputs(’Vi  Is  this  information  correct?  M)33A\076Y\b"); 

response  =  wgetchf("YN",’Y’); 

wclose(); 

I 

while  (response  !=  ’Y’); 
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/* 

Reset  the  hot  key  list. 

7 

chgonkey(kl ); 

/* 

Suspend  the  DMT  progtam  and  launch  the  Q_&_A.exe  program. 

7 

spawnl(P_WAIT."Q_&_A.exe","Q_&_A.exe", 

num_questions, "testl.txt", "expll.txt", NULL); 


/ * 

Returns  the  user  to  the  interface  if  he  is  not  inside  a  lesson; 
otherwise,  returns  the  user  to  the  lesson. 

7 

if  (!from_lsn) 
inenudemo( ); 
else 
exit(O); 
wcloseO; 

I 
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y*  ********************************************************************* 


FUNCTION  :  mainjmenu 

CALLED  BY:  dnit 

CALLS  :  whelpushc 
wmenubeg 
wmenuitem 
wmenuend 
wmwnuget 
whelpopc 

MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Defines  and  executes  the  main  menu  on  the  title  screen. 

***************************************************** ********** *******^ 

static  void  main_menu(void) 

{ 

/* 

Push  the  initial  help  screen  onto  the  help  screen  stack. 

*/ 

whelpushc(HJNITIAL); 

I* 

Define  and  process  the  main  menu. 

*i 

wmenubeg(.13,27,16,53,0,LBLUEI_BLUE,LBLUEI_BLUE,pre_menul ); 
wmenuitem(0,0, "Start  Demo", ’S’,l,M_CLOSB,menudemo, 0,0); 
wmenuitem(  1 .0,”Exit  demo”  ,’E’,6,0,NULL  ,0,0); 

wmenueiuH  1  ,M_VERT,25,3,LCYANI_BLUF ,  WHITEI_B  LUE,0.BLUEI_LGRE  Y ); 

if(wmenuget()=-l)  if(_winfo.emio>W_ESCPRESS)  error_exit(  1 ); 

/*  pop  the  global  help  category  off  of  the  stack,  and  into  the  void  */ 
whelpopc(); 

I 
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/**********  J************************************************************ 


FUNc  FION  :  nienudenio 

CALLED  BY:  calculator 
flash_cards 
logicexam 
tnainmenu 
pickalgorithm 
table 
rules 
venn 
venninfo 
view_notebook 

CALLS  :  whelpushc 
wopen 
error_exit 
top_bar 
interfacebar 
waitkey 

MODIFIED  :  4/12/90 

PERSON  :  Rick  Howard 

PURPOSE  :  Presents  the  interface  screen  and  waits  for  the  user  to  hit 
a  hot  key. 

at******************** *+********+*****+********************************/ 

static  void  menudemo(void) 

I 

/ * 

Open  the  interface  window. 

*/ 

if((w[l]=wopen(2,0,23,79,l,YELLOWI_BLUE,YELLOWI_BLUE))==0) 
eiTorexiK  1 ); 
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/* 

Draw  the  menu  bar  and  the  help  bar. 

*1 

top_bar(); 

interface_bar(); 

/* 

Push  the  user  interface  help  scrren  onto  the  help  stack. 

*/ 

whelpushc(HJJSERJNTERFACE); 

r 

Wait  for  the  user  to  choose  a  hot  key. 

*/ 

while  (waitkeyO  != 
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/**********************+******************************************+**** 


FUNCTION  :  notebook 

CALLED  BY:  parse_cmd_line 

CALLS  :  wmenubeg 
wmenuitem 
wmenuend 
whelpcat 
error_exit 

MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Defines  the  Notebook  menu  and  presents  the  menu  to  the  user. 

ft********************************************************************* 

I 

static  void  notebook(void) 

{ 

int  selection; 

wmenubeg(2.56,5,7 1 ,0,YELLOWI_BLUE,YELLOWI_BLUE,add_shadow); 
wmenuitem(0,0,"View  Notebook", ’V’,60,0, 

view_notebook,0,H_VIEW_NOTEBOOK_HELP); 
wmenuitem(l  ,0, "Print  Notebook", ’P’,61 ,0, 

print_note  book  ,0 ,  H_PR  INT_N  OTEB  OOK ) ; 
wmenuend(60,M_PDIM_SAVE,0, 1  ,YELLOWI_BLUE,LCYANI_BLUE,0 

,YELLOWI_LGREY); 

se  lect  ion=wmenu  get  () ; 

if(selection=-l&&_winfo.ermo>W_ESCPRESS)  error_exit(  1 ); 
whelpcat(H_USER_lNTERFACE); 

I 
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MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 


PURPOSE  :  Draws  the  background  for  the  title  screen 

af<%%^%a|c3«ea|cafc3fca(ca|eafc9«e3|eafca|c3te3«eafra|<a#ra«ea«ca|e4ca(ea|ea|c3|(a|ea|e9tcafe4cafea|e4ca|(3|ca«K4eafea|e9#>a|c9f(a«c4«att3#r3«(ak%a#t4cafca»ca|ca«c4cJ#Ka#ea«ca«ea|ej|c4eafe3fc 

i 

static  void  open_back_wind(void) 

{ 

register  int  i; 

if(!wopen(0,0,23,79,5,0,LGREENI_GREEN))  error_exit(l); 
for(i=l;i<320;i++)  wprintf("\033F%cDMT  ”,i); 

} 
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FUNCTION  :  open_titl_wind 
CALLED  BY:  dmt 


CALLS  :  wopen 

error_exit 

add_shadow 

wcenters 


MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Draws  the  title  window  for  the  title  screen. 


j**********************************************************************^ 


static  void  open_titl_wind(void) 

I 

if(!wopen(l,12,9,67,0,LREDI_MAGENTA,LREDI_MAGENTA))  error_exit(l); 
add_shadow( ): 

wcenters(0,WHITEI_MAGENTA, "Welcome  to  the  Discrete  Math  Tutor  (DMT) 
Prototype!"); 

wcenters(2,LCYANI_MAGENTA,"DMT:  1989-1990”); 
wcenters(3,LCYANI_MAGENTA,"by"); 
wcenters(4.LCYANI_MAGENTA,"Rick  Howard"); 
wcenters(5,LCYANI_MAGENTA,"&"); 
wcenters(6.LCYANI_MAGENTA, "Keith  Calcote"); 

) 
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j* ********************************************************************* 


FUNCTION  :  parse_cmd_line 
CALLED  BY:  dmt 


CALLS 


:  tools 
quit_menu 
notebook 


MODIFIED  :  4/12/90 


PERSON  :  Rick  Howard 

PURPOSE  :  Allows  the  user  to  call  specific  funtions  residing  in  the  DMT 
program  and  exit  while  the  lsn  program  is  running.  For 
example,  a  user  taking  the  logic  lesson  can  invoke  the  tools 
function  in  the  DMT. 

*  *  *  *  *  **  *  *  %  *  *  *  *  *  *  *  *  *  *  *  *  *  *  %  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  **  *  *  *  *  *  *  *  *  *  *  *  */ 


static  void  parse_cmd_line(int  argc,char  *argv[],int  *start_up) 

I 

char  *p;  /*  The  character  that  represents  the  cmd  line  argument  */ 
/* 

If  there  exists  command  line  arguments... 

*/ 

iffargc  >  1 ) 

{ 

p=argv[l]; 

if  ((*P  ==  ’T’)  II  (*p  ==  V)) 

I 

from_lsn  =  TRUE; 
tools(); 

from_lsn  =  FALSE; 

*start_up  =  0; 

I 

else  if  (*p  ==  ’Q’) 

I 

quit_inenu(); 

*start_up  =  0; 

} 
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else  if  (*p  ==  ’N’) 

( 

from_lsn  =  TRUE; 
notebook! ); 
fromlsn  =  FALSE; 
*stait_up  =  0; 

} 

} 

} 
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^♦itt******************************************************************** 


FUNCTION  :  pre_menul 

CALLED  BY :  main_menu 

CALLS  :  hidecur 

add_shadow 

MODIFIED  :  4/12/90 

PERSON  :  Rick  Howard 

PURPOSE  :  Hides  the  cursor  and  adds  a  shadow  to  a  menu. 


********************  jit*********  **********  **************  ************  ****y 


static  void  pre_menul(void) 

{ 

hidecurO; 

add_shadow(); 

I 
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/lie********************************************************************* 


FUNCTION  :  print_notebook 
CALLED  BY :  notebook 


CALLS  :  chgonkey 
wopen 
error_exit 
add_shadow 
wtitle 
winpbeg 
wprints 
winpdef 
winpread 
wputs 
wgetchf 
findfirst 
spawnl 

error_open_£ile 

wclose 


MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Queries  the  user  for  his  personalized  notebook  name  and 
sends  that  file  to  the  program  print.exe. 


**************************************************+*+*****************/ 


static  void  print_notebook(void) 

{ 

int  done;  /*  Used  to  indicate  if  the  notebook 


file  can  be  found  */ 

struct  ffblk  ffblk;  /*  Space  filler  used  in  the 

findfirst  function  */ 

struct  _onkey_t  *kl;  /*  Points  to  the  current  hot-key  list  */ 

register  int  response;  /*  Accepts  user’s  response  */ 
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/* 

Set  kl  =  to  the  current  hot-key  list  and  disable  ail 
hot -key  definitions. 

*/ 

kl  =  chgonkey(NULL); 

/* 

Open  the  window. 

*/ 

if( ! wopen(  10.8,17, 70, 1  ,LCY ANI_B LUE,  LCYANIJBLUE))  error.exit(l); 
add_shadow( ): 

wtit!e("|Name  Your  Personalized  NotebookJ",TLEFT,  LCYANI_BLUE); 

/*  Display  prompts  and  define  fields.  */ 
do( 

winpbeg(LGREENI_LGREY,WHITELLGREY); 

wprints(  1,  3,  WHITEI_BLUE,  "What  is  your  Notebook  Name?"); 

winpdef(  1, 35,  notebook_name,  "WWWWWWWWWWWW",0,0,NULL,0); 

/* 

Mark  end  of  form  and  process  it. 

*/ 

if(winpread())  break; 

/* 

Ensure  that  the  user  infonnation  is  correct. 

* / 

if  ( !  wopen(  1 5 ,24, 1 9,57,0,WHITEI_CY  AN,WHITEI_CY  AN))  error_exit(l); 
add_shadow( ); 

wputs("\n  Is  this  information  correct?  N033AN076YNb"); 

response  =  wgetchf("YN",’Y’); 

wclose(); 

} 

while  (response  !=  ’Y’); 

I* 

Find  the  user’s  notebook  in  the  current  directory. 

*/ 

done  =  findfirst(notebook_name,  &ffblk,  0); 
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/* 

If  the  user's  notebook  is  found  in  tiie  current  directory, 
send  the  user’s  notebook  name  to  the  program  print.exe. 

Otherwise,  display  an  error  message. 

*/ 

if  (done  ==  0  )  j 

spawnJ(P_WAIT,  "print.exe",  "print.exe",  notebook_name,  NULL); 

} 

else 

error_open_file(notebook_name); 


/* 

Close  the  window  and  enable  the  hot-key  list  again. 

*/ 

wclose(); 

chgonkey(kl); 
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*********************************************************************** 
FUNCTION  :  quit_menu 


CALLED  BY:  initialize 

parse_cmd_line 

CALLS  :  wmenubeg 
wmenuitem 
wmenuend 
wmenuget 
error_exit 
whelpcat 

MODIFIED  :  4/12/90 

PERSON  :  Rick  Howard 


PURPOSE  :  Displays  the  quit  menu  to  the  user 


^C**********************************************************************/ 


static  void  quitjmenu(void) 

I 

int  selection;  /*  The  user’s  menu  selection  */ 

/* 

Define  the  menu  structure. 

*/ 

wmenubeg(2,55,5,77,0,YELLOWI_BLUE,YELLOWI_BLUE,add_shadow); 
wmenuitem(0,0,"Save  Current  Position",’! ’,70,0, 

do-nothing  ,0  ,H_UN  A  V  AIL  AB  LE) ; 
wmenuitem(  1 ,0,"Exit",’E’,7 1  ,M_CLOSE,confinn_quit,0,H_EXIT); 
wmenuend(70,M_PDIM-SAVE,0,l,YELLOWI_BLUE,LCYANI_BLUE,0 

,YELLOWI_LGREY); 


/* 

Process  the  menu 

*/ 

select  ion=wmenuget( ) ; 

if(selection==-l&&_winfo.ermo>W_ESCPRESS)  error_exit(l ); 
whelpcat(H_USER_INTERFACE); 

) 
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j-tf  ***  *  *  ***  *  *  *  **********  *  *  *******  *  ******  *******  *  *  *  *  ****  *  ****  aft  ***  ******  * 


FUNCTION  :  table 
CALLED  BY:  tools 


CALLS  :  spawnl 

menudemo 

exit 


MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Suspend  the  dmt.exe  program  and  launch  the  table.exe  ■  «ogram. 


******* ***************************************************************/ 


static  void  table(void) 

I 

spawn](P_WATT,"table.exe", "table.exe", NULL); 


/* 

Returns  the  user  to  the  interface  if  he  is  not  inside  a  lesson; 
otherwise,  returns  the  user  to  the  lesson. 

*/ 

if  (!from_lsn) 
menudemo( ); 
else 
exit(0); 
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/******************************************************************** 


FUNCTION  :  tools 

CALLED  BY :  initialize 

parse_cmd_line 

CALLS  :  wmenubeg 
wmenuitem 
wmenuend 
wmenuget 
error_exit 
whelpcat 

MODIFIED  .-4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Displays  the  tools  menu  to  the  user. 
%*%*%***%*******#%**************%********%%%****#*%*****************%* 

static  void  tools(void) 

{ 

int  selection;  /*  The  user’s  menu  selection  */ 

/* 

Define  the  menu  structure. 

*/ 

wmenubeg(2,42,7,57,0,YELLOWI_BLUE,YELLOWI_BLUE.add_shadow); 

wmenuitem(0.0,"Diagrams",’D’,10,0,NULL,0,H_PICTURES); 

wmenubeg(8,42,10,56,0,YELLOWI_BLUE.YELLOWI_BLUE.add_shadow); 
wmenuitem(0,0,”Venn  Diagrams", ’V’, 5 l,0,venn,0,H_VENN_DIAGRAM_PICS); 
wmenuend(51,M_PDIM_SAVE,0,l,YELLOWI_BLUE,LCYANI_BLUE,0 

,YELLOWI_LGREY); 

wmenuitem(1.0,"Reference",’R’,ll,0,NULL,0, PREFERENCE); 

wmenubeg( 8,4 2, 1 1 ,55,0,YELLOWI_BLUE,YELLOWI_BLUE,add_shadow); 
wmenuitem(0,0, "Truth  Tables", ’T’, 70,0, 

do_nothing,0,H_TRUTH_TABLE_REF); 
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wmenubeg(  10,42,1 3, 48,O.YELLOWI_BLUE,YELLOWI_BLUE,add_shadow); 
wmenuitem(0,0, "Drill", ’D’,80.0.flash_cards,0,H_TRUTH_TABLE_DRlLL); 
wmenuitem(  1 ,0."Rules",’R,,8 1 .0,rules,0,H  JTRUTH_TABLE_RULES); 
wmenuend(80,M_PDIM_SAVE,0,l,YELLOWI_BLUE,LCYANI_BLUE,0 

,YELLOWI_LGREY ); 

winenuitem(  1 ,0,"Venn  Diagrams", ’V’, 71 ,0, 

venninfo,(),H_TR  UTH_T  AB  LE_REF); 
wmenuend(70,M_PDIM_SAVE,0,l,YELLOWLBLUE,LCYANLBLUE,0 

,YELLOWI_  LGREY ); 

wmenuitem(2.0, "Calculator", ’C’,  12,0, calculator  ,0,H_CALCULATOR); 
wmenuitem(3,0,"Problem  Solver", ’P’.  1 3,0, 

do_nothing.O,H_PROBLEM_SOLVER); 

wmenubegt  8.42.1 0,55, 0.YELLOWLBLUE,YELLOWI_BLUE,add_shadow); 
wmenuitem(0  O.'Truth  Tables", ’T‘,40,0, 

table,0,H_TRUTH_TABLE_PROBLEM_SOLVER); 

wmenuend(40,M_PDIM_SAVE,0,l,YELLOWIBLUE,LCYANI_BLUE.0 

,YELLOWI_LGREY); 


wmenuend(10.M_PD!M_SAVE,0,l.YELLOWLBLUE,LCYANLBLUE,0 

,YELLOWl_LGREY ); 


/* 


Process  the  menu. 


*/ 

selection=wmenuget( ); 

if(selection==-I&&_winfo.ermo>W_ESCPRESS)  error_exit(  1 ); 
whelpeauH_USERJNTERFACE); 

I 
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/********************************************************************** 


FUNCTION  :  rules 

CALLED  BY:  tools 

CALLS  :  spawnl 

menudemo 

exit 

MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Suspend  the  dnit.exe  program  and  launch  the  rules.exe  program. 

static  void  rules(void) 

I 

spawnl(P_W  AIT, "rules.exe","rules.exe", NULL); 

/* 

Returns  the  user  to  the  interface  if  he  is  not  inside  a  lesson; 
otherwise,  returns  the  user  to  die  lesson. 

*/ 

if  (!from_lsn) 
menudemol ); 
else 
exit(0); 
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FUNCTION  :  verm 

CALLED  BY:  tools 

CALLS  :  spawnl 

menudemo 

exit 

MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 

PURPOSE  :  Suspend  die  dint  exe  program  and  launch  the  venn.exe  program. 

*  *  *  *  *  *  *  **  *  ***  *  %  *  *  *  *  ***  4c  *  ***  *  *****  *************  **  *****  *  **  **  **  *  ******** 


static  void  venn(void) 

{ 

spawnI(P_W  AIT, "venn.exe", "venn.exe", NULL); 

/* 

Returns  the  user  to  the  interface  if  he  is  not  inside  a  lesson; 
otherwise,  returns  the  user  to  the  lesson. 

*/ 

if  (!from_lsn) 
menudemoO; 
else 
exit(0); 
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static  void  venninfo(void) 

I 

spawnl(P_WAlT,"venninfo.exe","venninfo.exe",NULL); 

I* 

Returns  the  user  to  the  interface  if  he  is  not  inside  a  lesson; 
otherwise,  returns  the  user  to  the  lesson. 

*/ 

if  (!from_lsn) 
menudemo( ); 
else 
exit(O); 

) 
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FUNCTION  :  viewnotebook 

CALLED  BY:  notebook 

CALLS  :  chgonkey 
wopen 
error_exit 
add_shadow 
wtitle 
winpbeg 
wprints 
winpdef 
winpread 
wputs 
wgetchf 
wclose 
findfirst 
strbtrini 
spawnl 
menudemo 
exit 

error_open_file 
MODIFIED  :  4/12/90 
PERSON  :  Rick  Howard 


PURPOSE  :  Prompts  the  user  for  his  personalized  notebook  name  and  sends 
that  name  to  the  lsn.exe  program. 


*  *  ******* ******* * * * *** * * ** ** * * *** * ** * * * ***** *** * ****** * * *  * ** *** ** * **** 


static  void  view_notebook(void) 

I 

struct  ffblk  ffblk;  /*  Used  as  a  place  filler  in  the 

findfirst  function  */ 


struct  _onkey_t  *kl;  /*  Points  to  the  defined  hot -key  list  */ 
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int  done; 


/*  Used  to  indicate  if  the  user’s 

personalized  notebook  name  is  found  in 
the  current  directory  */ 

register  int  response;  /*  Holds  the  user’s  response  */ 

/* 

kl  points  to  the  current  hot-key  list  and  all  hot-keys  are 
disabled. 

*/ 

kl  =  chgonkey(NULL); 

/* 

Open  the  window. 

*/ 

if( ! wopen(  1 0.8 , 1 7 ,70, 1  ,LCY ANI_B LUE,  LCY ANI_B LUE))  error_exit(l); 
add_shadow( ); 

wtitle("|Name  Your  Personalized  Notebook] ",TLEFT,  LCYANI_BLUE); 

/* 

Display  prompts  and  define  fields. 

*/ 
do  { 

winpbeg(LGREENl_LGREY,WHlTEI_LGREY); 

wprints(  1 , 3,  WHITEI_BLUE,  "What  is  your  Notebook  Name?"); 
winpdef(  1, 35,  notebook_name,  "WWWWWWWWWWWW",0,0,NULL,0); 

/* 

Mark  end  of  form  and  process  it. 

*/ 

if(winpread())  break; 
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/* 

Ensure  that  the  user  information  is  correct. 

*/ 

if  ( !wopen(15, 24, 19,57,0, WHITELCY  AN, WHITEI_CY  AN))  error_exit(l ); 
add_shadow(); 

wputs("\n  Is  this  information  correct?  \033A\076Y\b"); 

response  =  wgetchf("YN",’Y’); 

wclose(); 

} 

while  (response  !=  ’Y’); 

/* 

Enable  the  hot-key  list. 

*/ 

chgonkey(kl); 

/* 

Find  the  user’s  notebook  in  the  current  directory. 

*/ 

done  =  findfirst(notebook_name,  &ffblk,  0); 

/* 

If  the  user's  notebook  is  found  in  the  current  directory, 
modify  it  with  the  program  txtmod.exe  and  send  the 
results  to  the  program  lsn.exe.  Otherwise,  display  an 
error  message. 

*/ 

if  (done  ==  0) 

I 

strbtrim(  notebook_name ) ; 

spawnl(P_WAJT,”txtmod.exe", "txtmod.exe", notebook_name, 
"notebook.out",NULL); 

spawnl(P_W  AIT, "lsn.exe", "lsn.exe", "notebook.len", "notebook.txt”, NULL); 
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/* 

Returns  the  user  to  the  interface  if  he  is  not  inside  a  lesson; 
otherwise,  returns  the  user  to  the  lesson. 

*/ 

if  (!from_lsn) 
menudemoO; 
else 
exit(O); 

) 

else 

error_open_file(notebook_nanre); 

/* 

Close  the  window. 

*/ 

wclose(); 
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APPENDIX  F 


THE  CODE:  FILE  "LSN.C" 


/***********************,i,******,(,***1(,*l|,***************1)<J),+:(<])(1(,,l,J(,1((*1|<,(,J)(%l),1)11(t,)tJ|t 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 

LIBRARY  CALLS: 


atoi 

Turbo  C  Lib 

error_exit 

DMT  Utilities 

exit 

DMT  Utilities 

fclose 

Turbo  C  Lib 

fopen 

Turbo  C  Lib 

find_card 

Link  Utilitites 

fread 

Turbo  C  Lib 

fseek 

Turbo  C  Lib 

getche 

Turbo  C  Lib 

initiailize_linked_list 

Link  Utilities 

setonkey 

CXLLib 

set_video 

DMT  Utilities 

spawnl 

Turbo  C  Lib 

top_bar 

DMT  Utilities 

wactiv 

CXL  Lib 

waitkey 

CXL  Lib 

wborder 

CXLLib 

wclose 

CXL  Lib 

whelpcat 

CXL  Lib 

whelpdef 

CXL  Lib 

wmenubeg 

CXLLib 

wmenuend 

CXL  Lib 

wmenuget 

CXL  Lib 

wmenuitem 

CXL  Lib 

wmessage 

CXL  Lib 

wopen 

CXL  Lib 

wprintf 

CXL  Lib 

write_file 

Link  Utilitites 
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PROGRAM  CALLS: 

dmt.exe 

LSN  FUNCTIONS: 

continuejsn 

enter_page 

lsn_bar 

main 

notebook 

pageclr 

page_down 

page_up 

quit 

quit_menu 

saveposition 

top_bar 

tools 

COMPLETED:  4/12/90 

PERSONS:  Keith  Calcote  &  Rick  Howard 

PURPOSE:  To  display  a  lsn  inside  the  DMT  user  interface. 
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/*  Header  Files  */ 

#include  <stdio.h> 

#include  <process.h> 

#include  <bios.h> 

#include  <alloc.h> 

#include  <dir.h> 

#include  "d:\cxl\cxlstr.h" 

#include  "d:\cxFcxlwin.h" 
#include  "d:\cxFcxlkey.h” 
#include  "d:\cxIVxlvid.h" 
#include  "d:\ic\lhesis\globals.h" 
#include  ''d:\tc\thesis\defs.h" 
#include  "d:\tc\ihesis\help.h" 
#include  "d:\tc\ihesis\util.h" 
#include  "d:\tc\fhesis\link.c" 
#include  "d:\tc\thesis\video.h" 
/* . 
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/*  function  prototypes  */ 

static  void  add_shadow(void); 
static  void  continue_lsn(void); 
static  void  error_exit(int  ermum); 
static  void  enter_page(void); 
static  void  information(void); 
static  void  notebook(void); 
static  int  pageclr(void); 
static  void  page_down(void); 
static  void  page_up(void); 
static  void  quit(void); 
static  void  quit_menu(void); 
static  void  save_position(void); 
static  void  set_video(void); 
static  void  tools(void); 

/* - */ 

/*  Constants  */ 

#define  LEN  50 
#define  PAGEL  1000 

/* . */ 
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/*  Global  Variables  */ 


static  WINDOW  w[  I  ft]-  /*  Array  of  window  handles  */ 

static  FILE  *fptrl,  /*  Pointer  to  the  lesson  length  file  */ 

static  FILE  *fptr2  ;  /*  Pointer  to  the  lesson  text  file  */ 

static  int  ch;  /*  Used  to  get  the  user’s  response  */ 

static  int  recno  ;  /*  Indicates  the  page  number  for  the  lesson  */ 

static  int  temp,templ  ;  /*  Used  to  calculate  the  user’s  desired  page 

number.  */ 

static  char  page[PAGEL] ;  /*  Holds  the  contents  of  the  lesson  */ 

static  char  *ARGS[3);  /*  Holds  the  arguments  needed  to  save  the 

user’s  position  in  any  lesson  */ 

/*--  - v 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 

Rick  Howard  &  Keith  Calcote 
See  Declarations 


void  main(int  argc,char  *argv[]) 

I 

/* 

Defiiie  all  hot  keys. 

*/ 


setonkey(0x5 1 00,page_down,0); 

/*  Page  down  */ 

setonkey(0x4900,page_up,0); 

/*  Page  up  */ 

setonkey  (Ox 1 900,enter_page  ,0); 

/*  ALT  P  V 

setonkey(0x3062,begin_lsn,0); 

/*  B  */ 

setonkey(0xl769,infomiation,0); 

1*1*1 

setonkey(0x  1 474 .tools, 0); 

1*1*1 

setonkey(0x3 16E,notebook,0); 

/*  N  */ 

setonkey  (Ox  107 1  ,quit_menu,0); 

/*  Q  */ 

setonkey  (0x2D7  8  ,qu  it  ,0 ) ; 

l*x*i 

setonkey(0x326D, memory  ,0); 

/*  M  */ 

/* 

Define  the  help  screen  attributes. 

*/ 

whelpdef("DMT.HLP", 0x2368, BLACKI_LGREY.B LACK!  LGREY. 

LB  LU  EI_LGRE  Y  ,LREDI  JLGREY  ,pre_help) ; 


/* 

Draw  the  menu  bar  and  the  help  bar. 

*/ 

top_bar(); 

lsn_bar(); 

/* 

Check  for  mono,  CGA  or  EGA  screen. 

*/ 

set_video(); 
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/ * 

Open  a  window  to  display  the  user  selected  lesson. 

*/ 

if U  w  1 1  ]=w  open(2 ,0,23,79,3 ,  WH1TEI_C  Y  AN ,  W  HTTEI_C  Y  AN  ))==0 ) 
error_exit(  l ); 

wmessage("lPgUp/PgDn]",BT_BORD,9,YELLOWI_BLACK); 

/* 

Open  the  Lesson  Length  file  and  store  the  name  for  use  by 
the  save_position  function. 

*/ 

if(  (fptrl=fopen(argv[l],"r"))  ==NULL  ) 

( 

wprintff  CAN’T  OPEN  THIS  FILE: 

%sV’,argvll]); 

waitkeyO; 

exit(O); 

} 

else 

ARGS[1]  =  argv[l]; 

/* 

Open  the  Lesson  Text  file  and  store  the  name  for  use  by 
the  save_position  function. 

*/ 

if(  (fptr2=fopen(argv[2],"rb"))  —NULL  ) 

{ 

wprintff  ”C AN ’T  OPEN  THIS  FILE: 

%s\n",  argv[2J); 

waitkeyO; 

exit(0); 

} 

else 

ARGS[2]  =  argv[2]; 

/* 

Read  the  lesson  length  file. 

*/ 

fread(&length.sizeof(length),l  ,fpti  1 ); 
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/* 

Determine  the  user  defined  page  number. 

*/ 

if(argv[3]  !=  NULL) 
recno  =  atoi(argv[3J); 
else 

recno  =  1 ; 


/* 

Begin  the  lesson. 

*/ 

continue_lsn(); 

} 
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^*  ********************************************************************* 


FUNCTION  : 
CALLED  BY: 


CALLS 


continuejsn 

Isn 

enter_page 

notebook 

page_down 

page_up 

tools 

whelpcat 

wactiv 

wmessage 

wprintf 

fseek 

pageclr 

fread 

wputns 

waitkey 

wernnsg 


MODIFIED:  4/12/90 

PERSON  :  Rick  Howard  &  Keith  Calcote 

PURPOSE  :  Displays  the  proper  page  number  to  a  lesson  based  upon 

the  user’s  input. 


***********************************************************************/ 


static  void  continue_lsn(void) 

I 

/* 

Set  the  help  screen  that  applies  to  any  generic  lesson. 

*/ 

whelpcat(H_LSN_HELP); 

/* 

Make  the  lesson  window  the  active  window. 

*/ 

wactiv(w[l]); 


/* 

Display  a  help  message  across  the  border  of  the  lesson  window. 

*/ 

wmessage("[PgUp/PgDn]",BT_BORD,9,YELLOWI_BLACK); 
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/* 

Display  the  page  number. 

*/ 

wpruitf('VVi\t\t\t\t\tNt\t\tpage  %<JSAn",recno) ; 

/* 

Get  the  current  page  from  disk  and  display  it  in  the  active  window. 

*/ 

offset  =  lengthjrecno] ; 
if(  fseek(fptr2,offset,0)  !=  0) 

I 

wprintffCANT  MOVE  POINTER  THERE") ; 
exit(0) ; 

) 

pageclrO  ; 

fread(page,length|recno+l ]-length[recno],l ,fptr2) ; 
wputns(page,length[recno+lj-length[recno]); 

/* 

If  last  page  of  the  lesson,  cycle  back  to  the  first  page. 

*/ 

if(recno  >  length[0]) 
recno  =  1 ; 


I* 

Wait  for  the  user’s  response. 

V 

while  (waitkeyO  1=  0x4C35); 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


enter_page 

lsn 

wprintf 

getche 

continue_lsn 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Allows  the  user  to  choose  any  page  in  the  lesson  to  view. 


ft*********************************************************************/ 


static  void  enter_page(void) 

{ 


/* 


Initialize  some  temporary  variables. 

*/ 

temp  =  0  ; 
temp  1  =  recno  ; 

wprintf("\rEnter  page  number:  ") ; 
while(  (ch  =  getche(»  !=  13) 

I 

if  (  ch  <=  57  &&ch>=  48) 

( 

temp  =  temp*  10  +  ch-48  ; 
recno  =  temp  ; 

} 

else 


wprintff  NOT  A  VALID  PAGE  NUMBER  W); 
recno  =  tempi  ; 
break  ; 

) 


if(recno  >  length[0]) 
recno  =  1  ; 


/* 

Display  the  selected  page. 

*/ 

continue_lsn(); 

I 
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/♦♦a******************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


notebook 

lsn 

spawnl 

top_bar 

lsn_bar 

wactiv 

wborder 

continue_Isn 

4/12/90 

Rick  Howard 

Suspends  the  lsn.exe  program  and  calls  the  dmt.exe  program 
to  utilize  the  user  interface’s  notebook  functionality. 


4c  ****  **  **  *  *  ***  *  *  **  *  ****  *  *****  *  *  ***********  ***  ***  *  **  ***************  ***  * 


static  void  notebook(void)' 

{ 

/* 

Set  up  tire  command  line  for  the  dmt.exe  program. 

*/ 

char  *argsf31; 
argslO|  =  "dmt.exe"; 
args|l]  =  "dmt.exe"; 
args[2]  =  "N"; 
args[3]  =  NULL; 

/* 

Call  the  dmt.exe  program. 

*/ 

spawnl(P_WAIT,args[0],argsll],  args[2],NULL); 

/* 

Re-establish  the  lesson  screen. 

*/ 

top_bar(); 

lsn_bar(); 

wactiv(wllj); 

wborder(3); 

continue_lsn(); 

) 
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1+  *  *  **  *  ******  *  **  *****  *  ******  *  *  %  *  *  ***  *  ****  *  *  **  >fc  *  ***  ***  **  ****  **  *  ***  *****  * 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


pageclr 

continue_lsn 

NONE 

4/12/90 

Rick  Howard  &  Keith  Calcote 
Clears  the  page  buffer 


♦♦a***********************************************#********************/ 


static  int  pageclr(void) 

I 

*page  =  V00'  ; 

} 


^* ********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED : 
PERSON  : 
PURPOSE  : 


page_down 

lsn 

continue_lsn 

4/12/90 

Rick  Howard  &  Keith  Calcote 
Sets  the  lesson  page  number  to  the  next  page  or,  if  the 
current  page  is  the  last  page  of  the  lesson,  sets  the 
lesson  page  number  to  page  1 . 


***********************************************************************/ 


static  void  page_down(void) 

I 

recno  ++  ; 

if(recno  >  length[0]) 
recno  =  1  ; 
continue_lsn(); 

} 
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/*********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


page_up 

lsn 

continue_lsn 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Sets  the  lesson  page  number  to  the  previous  page  or,  if  the 
current  page  is  the  first  page  of  the  lesson,  sets  the 
lesson  page  number  to  the  last  page  of  the  lesson. 


I**********************************************************************/ 


static  void  page_up(void) 

[ 

recno  —  ; 
if(recno  <=  0) 
recno  =  length[0] ; 
continue_lsnO; 
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j  *  *  ***  *  Jfc  *  *  *  *  *  **  *  **  i|t  *  **  *  *****  *  ******  *  *****  *  **  *  *  ***  %  3(e  *  *  *  *  l|l  *  ]|t  *  *  *  *  1ft  *  *  *  *  *  *  %  * 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


quit_menu 

lsn 

wmenubeg 

wmenuitem 

wmenuend 

wmenuget 

error_exit 

whelpcat 

4/12/90 

Rick  Howard 

Defines  the  quit  menu  structure. 


*  *  *  **  *  *  *  *  *  *  *  *  **  *  *  *  *  *  *  *  *  **  *  *  ***  *  *  *  *  *  ****  ****  *  *  *  *  lit  **  *  %  *  *  *  *****  *  *  *  *  **  *  *  **  j 


static  void  quit_menu(void) 

I 

int  selection;  /*  The  user’s  menu  choice  */ 


/* 

The  menu  structure. 

*/ 

wmenubeg(2,55,6,77,0,YELLOWI_BLUE,YELLOWLBLUE,add_shadow); 
wmenuitem(0,0,"Save  Current  Position", ’S’,70,M_CLOSE, 
save_position,0,H_SAVE_POSITION); 
winenuitem(  1 ,0,"Display  Results", ’D’, 7 1  ,M_CLOSE,do_nothing,0,0); 
winenuitem(2,0,"Exit",’E’,72,M_CLOSE,quit,0,H_EXIT); 
wmenuend!  70,M_PDIM_S  A  VE,0, 1  ,YELLOWI_B  LUE, 

LCYANI_BLUE,0,YELLOWI_LGREY); 


/* 

Process  the  menu 

*/ 

selection=wmenuget(); 

if(selection==-l&&_winfo.ermo>WJESCPRESS)  error_exit(  1 ); 
whelpcat(H_LSN_HELP); 

) 
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^* ******************* ************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


save_position 

quit_menu 

initial  ize_linked_list 

find_card 

write_file 

quit 

4/12/90 

Rick  Howard 

Saves  the  user’s  current  page  number  and  lesson  name  to 
disk  so  that  the  user  may  return  to  it  later. 


************************************* *********************************/ 


static  void  save_position(void) 

{ 

int  start_lsn  =  FALSE;  /*  Used  in  the  find_card  function  indicating 

the  user  is  ending  a  session  and  not 
beginning  one  */ 

/* 

Bring  in  all  the  saved  positions  from  disk  and  place  into 
a  linked  list. 

*/ 

initialize_linked_list(); 

/* 

Get  the  user’s  SSN.  Place  the  SSN,  the  lesson  name  and  lesson 
page  number  into  the  linked  list. 

*/ 

find_card( ARGS  [  1  ]  ,ARGS  [2]  ,recno,  star t_lsn); 

/* 

Write  the  linked  list  to  disk. 

*/ 

write_file("cardfile.dat " ); 

/* 

Exit  the  program. 

*/ 

quit(); 

} 
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^J^************************************),.***: I'**************************:*, 


FUNCTION : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


tools 

lsn 

spawnl 

top_bar 

lsn_bar 

wactiv 

wborder 

continue_lsn 

4/12/90 

Rick  Howard 

Suspends  the  lsn.exe  program  and  calls  the  dmt.exe  program 
to  utilize  the  user  interface’s  tools  functionality. 


*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  **  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  t  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *j 

static  void  tools(void) 

{ 

/* 

Set  up  the  command  line  for  the  dmt.exe  program. 

*/ 

char  *args[3J; 
argslOJ  =  "dmt.exe"; 
args[  1 J  =  "dmt.exe"; 
args[2]  =  "T"; 
args[3J  =  NULL; 

/* 

Call  the  dmt.exe  program. 

*/ 

spawnl(P_WAlT,args[0],args[l],  argsl2],NULL); 

/* 

Re-establish  the  lesson  screen. 

*/ 

top_bar(); 

lsn_bar(); 

wactiv(w[l]); 
wborder(3); 
continue  _lsn(); 


) 
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APPENDIX  G 


THE  CODE:  FILE  "UTIL.H" 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 

LIBRARY  CALLS: 


chgonkey 

CXL  Lib 

clearkeys 

CXL  Lib 

error_exit 

DMT  Utilities 

execl 

Tubro  C  Lib 

exit 

Turbo  C  Lib 

fclose 

Turbo  C  Lib 

fopen 

Turbo  C  Lib 

fprintf 

Turbo  C  Lib 

gotoxy 

Turbo  C  Lib 

hklecur 

CXL  Lib 

printf 

Turbo  C  Lib 

return 

Turbo  C  Lib 

showcurs 

CXL  Lib 

spawnl 

Turbo  C  Lib 

srestore 

CXL  Lib 

waitkey 

CXL  Lib 

wcenters 

CXL  Lib 

wclose 

CXL  Lib 

wcloseall 

CXL  Lib 

wgetchf 

CXL  Lib 

whelpcat 

CXL  Lib 

winpbeg 

CXL  Lib 

winpdef 

CXL  Lib 

winpread 

CXL  Lib 

wnienubeg 

CXL  Lib 

wmenuend 

CXL  Lib 

wmenuget 

CXL  Lib 

wmenuitem 

CXL  Lib 

wmessage 

CXL  Lib 

wopen 

CXL  Lib 
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LIBRARY  CALLS  (CONTINUED): 


wpickstr 

CXL  Lib 

wprintf 

CXL  Lib 

wprints 

CXL  Lib 

wputs 

CXL  Lib 

wreaderrs 

CXL  Lib 

wshadow 

CXL  Lib 

wtitle 

CXL  Lib 

PROGRAM  CALLS: 

Isn.exe 

UTIL  FUNCTIONS: 

add_shadow 

add_to_notebook 

begin_lsn 

confirm_quit 

defnotebook 

defprint 

do_nothing 

error_close_file 

error_empty_ssn 

errorexit 

error_open_file 

error_ssn 

get_last_lsn 

information 

interface_bar 

introduction_bar 

normal_exit 

openjnotebook 

pick_algorithm 

pickdef 

pre_help 

pre_pickl 

press_a_key 

quit 

logic_lsn 

lsn_bar 

memory 

top_bar 

you_selected 
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COMPLETED: 


4/12/90 


PERSONS: 


Rick  Howard 


PURPOSE: 


Provides  utility  functions  that  both  the  dint.exe  and  lsn.exe 
programs  use. 


**********************************************************************/ 
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/*  Constants  */ 


#clefine  CLR  "\xlBl2J" 

#define  NBYTES  128 

#define  SSNSIZE  15 

#define  LSN_LENGTH_SIZE  20 

#define  LSN_NAME_SIZE  20 

#tlefine  LSN_PAGE_NUM_SIZE  5 

#defineTRUE  1 

#define  FALSE  0 

/* - */ 

/*  function  prototypes  */ 

static  void  add_shadow(void); 

static  void  add_to_notebook(void); 

static  void  begin_lsn(void); 

static  void  confirm_quit(void); 

static  void  defhotebook(void); 

static  void  defpi  int(void); 

static  void  do_nothing(void); 

static  void  error_close_file(char  name [12]); 

static  void  error_empty_ssn(void); 

static  void  error_exit(int  emium); 

static  void  error_open  file(chai  name[12]); 

static  void  error_ssn(void); 

static  void  get_last_lsn(void); 

static  void  information(void); 

static  void  interface_bar(void); 

static  void  introduction^arlvoid); 

static  void  normal_exit(void); 

static  void  open_notebook(void); 

static  void  pick_algorithm(void); 

static  void  pickdef(void); 

static  void  pre  help(void); 

static  void  pre_pickl(void); 

static  void  press_a_key(int  wrow); 

static  void  <|uit(void); 

static  void  logic_lsn(void); 

static  void  lsn_bar(void); 

static  void  memory(void); 

static  void  top_bar(void); 

static  void  you_selected(char  *str); 
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/*  Globals  */ 


static  char  *error_text(l=  { 

NULL,  /*  ermum  =  0,  no  error  */ 
NULL,  /*  ermuni  ==  1,  windowing  error  */ 

ii  tt 

error 

"Can  not  find  the  notebook" 

}: 


/********************************************************************** 


FUNCTION  : 
CALLED  BY: 


CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


add_shadow 

begin_lsn 

in  util.h 

confinn_quit 

in  util.h 

defnotebook 

in  util.h 

error_close_file 

in  util.h 

error_empty_ssn 

in  util.h 

error_open_file 

in  util.h 

error_ssn 

in  util.h 

exams 

in  dmt.exe 

get_ssn 

in  lsn.exe 

information 

in  util.h 

logic_exam 

in  dmt.exe 

notebook 

in  dmt.exe 

open_notebook 

in  util.h 

open_title_wind 

in  dmt.exe 

pickdef 

in  util.h 

pre_help 

in  util.h 

pre_menu  1 

in  dmt.exe 

pre_pickl 

in  util.h 

print_notebook 

in  dmt.exe 

quit_menu 

in  dmt.exe 

quit_menu 

in  lsn.exe 

tools 

in  dmt.exe 

view_notebook 

in  dmt.exe 

wshadow 

4/12/90 

Rick  Howard 

This  function  will  add  a  shadow  to  the  active  window 

4c  *********************  **  *  *  4,4,4,  *  **  *  ***  *  *  *  **  *  *  %  *  ******  *  **  *  ^  ^  ^  ^  ^  ^ 


static  void  add_shadow(void) 

{ 

wshadow(LGREYI_BLACK); 

} 
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/*****+**************************************+*************+*+********* 


FUNCTION : 
CALLED  BY: 
CALLS  : 


MODIFIED : 
PERSON  : 
PURPOSE  : 


add_to_notebook 
defnotebook  in  util.h 
fopen 

error_open_file 

return 

fprintf 

getc 

putc 

fclose 

error_close_file 
4/12/90 
Rick  Howard 

This  function  retrieves  a  file  name  and  appends  the  file  to 
the  notebook 


*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  ★  *  *  ★  *  %  %  *  4c  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  ♦  *  *  It/ 

static  void  add_to_notebook() 

I 

int  c;  /*  Holds  the  character  values  that  are  transfered  from  the 

user’s  selected  definition  to  his  notebook  file  */ 

FILE  *f;  /*  Pointer  to  the  user’s  selected  file  */ 

/* 

Get  the  name  of  the  user’s  notebook. 

*/ 

open_notebook( ) ; 
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/* 

Based  on  the  user's  selected  defintion,  append  that  definition 
file  to  the  user's  notebook. 

*/ 

switch  (definitions[def_number][0] )  j 
case  GRAPH  : 

I 

if  ((f  =  fopen( "graph. def' ,  "rH»  ==  NULL) 

I 

error_open_file("gaph.def’); 

return; 

I 

fprintf(current_notebook,'\nVi"); 
while((c  =  getc(f))  !=  EOF)  putc(c,current_notebook); 
if  (fclose(f)  ==  EOF) 
error_close_file("graph.def’); 
break; 

I 

default : 
break; 

) 

if  (fclose(current_notebook)  ==  EOF) 
error_close_file(notebook_nanie); 

} 
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/**************************************************:('******************* 


FUNCTION  : 
CALLED  BY: 

CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


begin_Isn 

initialize  indmt.exe 

main  in  lsn.exe 

wmenubeg 

wmenuitem 

wmenuend 

wmenuget 

error_exit 

whelpcat 

4/12/90 

Rick  Howard 

Displays  the  Begin  menu 


********************  **  ****  *******  I*************  *******  **  *i|<  *************/ 


static  void  begin_lsn  (void) 

I 

int  selection;  /*  The  user’s  menu  choice  */ 

wmenubeg(2,3,5,25,0,YELLOWI_BLUE,YELLOWI_BLUE,add_shadow); 
wmenuitem(0.0, "Start  a  Lesson", ’S’, 20, 0,do_nothing,0,H_START_LSN ); 

wmenubeg(6,3,8,9,0,YELLOWI_BLUE,YELLOWI_BLUE,add_shadow); 
wmenuitem(0,0,"Logic",’L’,31,M_CLOSE,logic_lsn,0,H_LOGlC); 
wmenuend(3 1  ,M_PDIM_SAVE,0,  l,YELLOWI_BLUE, 

LCY  ANI_BLUE,0,YELLOWI_LGREY); 

wmenuitem(  1 ,0, "Return  to  Last  Lesson", ’R’, 21, M_CLOSE, 
get_last_lsn,0,H_RETURN_TO_LAST_LSN); 
wmenuend(20,M_PD!M_S  AVE,0, 1  ,YELLOWI_B  LUE, 

LCYANI_BLUE,0,YELLOWI_LGREY); 


selection=wmenuget( ); 

if(selection==-l&&_winfo.ermo>W_ESCPRESS)  error_exit(  1 ); 
whelpcat(H_USER_INTERFACE); 

} 
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/******  ******  *  ***  **  l***********  ft***  ***l|t=l<  *******  ******  ******************* 


FUNCTION  : 
CALLED  BY: 


CALLS 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


confimi_quit 
initialize 
quitjmenu 
pre_help 
press_a_key 
chgonkey 
wopen 
error_exit 
add_shadow 
wputs 
clearkeys 
showcurs 
wgetchf 
normal_exit 
wclose 
hidecurs 
v’printf 
4/12/90 
Rick  Howard 

This  function  pops  open  a  window  and  confirms  that  the  user 
really  wants  to  quit  the  demo.  If  so,  it  terminates 
the  demo  program. 


in  dmt.exe 
in  dmt.exe 
in  util.h 
in  util.h 


*  *  *  %  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  %  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  4c  *  *  *  *  %  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  ifj 


static  void  confinn_quit(void) 

I 

struct  _onkey_t  *kblist;  /*  Pointer  to  the  list  of  active  hot-keys  */ 
/* 

Set  a  pointer  to  the  hot-key  listfor  future  reference  and 
disable  all  the  hot  keys. 

*/ 

kblist=chgonkey(NULL); 
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/* 

Open  the  message  window. 

*/ 

if(!wopen(9,26,13,55,0,WHrTEI_BROWN,WHITEI_BROWN))  error_exit(l ); 
add_shadow(); 

wputs("\n  Quit  DMT,  are  you  sure?M)33A\156YNb"); 

clearkeysQ; 

showcur(); 

/* 

If  the  user  wants  to  exit,  terminate  the  program.  If  not, 
reactivate  the  hoy-key  list  and  close  the  window. 

*/ 

if(wgetchf( "  YN" ,  ’  Y  ’  )== ’  Y  ’)  normal_exit( ); 

wclose(); 

hidecur(); 

chgonkey(kblist); 

wprintf("%d\n",  coreleft()); 

) 
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/*****************+***********************************+***************+ 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


defnotebook 

pickdef  in  util.h 

wmenubeg 

wmenuitem 

wmenuend 

wmenuget 

error_exit 

4/12/90 

Rick  Howard 

Displays  the  Notebook  menu 


static  void  defiiotebook(void) 

{ 

int  choice;  /*  The  user’s  menu  choice  */ 

wmenubeg(  1 8 . 25 ,2 1 ,5 2,0,  YELLOW  l_B  LUE,  YELLO  WI_B  LUE,add_shadow); 
wmenuitem(0,0,"Add  Definition  to  Notebook" , ’ A ’ ,20,M_CLOSE, 
add_to_notebook,0,0); 

wmenuitemf  1,0, "Print  Definition” , ’ P ’ ,2 1  ,M_CLOSE,defprint ,0,0); 
wmenuend(20,M_VERT,0,0,YELLOWIJBLUE, 

LCYANI_BLUE,0,YELLOWI_LGREY); 


choice  =  wmenugetf); 

if(choice  ==  -1  &&  _winfo.ermo>  W  ESCPRESS)  error_exit(l); 

) 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


defprint 

defnotebook  in  util.h 

spawnl 

4/12/90 

Rick  Howard 

Sends  the  user  selected  definition  file  to  the  program 
print.exe  for  printing 


static  void  defjprint(void) 

( 

switch  (definitions[def_number][OJ)  { 


case  GRAPH  : 

spawnl(P_WAIT,"prilit.exe",  "print.exe",  "graph.def NULL); 
break; 


default : 
break; 


I 
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/****  ********************************************  *******  ********  ******* 


FUNCTION  : 
CALLED  BY: 


CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


dojnothing 

quit  jmenu  in  dmt.exe 

tools  in  dmt.exe 

quit_menu  inlsn.exe 

begin_lsn  in  util. h 

infoimation  in  util.h 

NONE 
4/12/90 
Rick  Howard 

This  function  is  used  as  a  dummy  function  for 
several  menu  items  in  the  pull-down  demo 


************************************** **************** ****************^ 


static  void  do_nothing(void) 


/************************************************************+******** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


error_close_fiJe 

add_to_notebook  in  dmt.exe 

wopen 

error_exit 

add_shadow 

wprintf 

wclose 

4/12/90 

Rick  Howard 

Error  message  if  the  system  can  not  properly  close  a  file 


static  void  error_close_file(char  name[12]) 

I 

if  ( !wopen(  1 5,24, 19,57,0,  WHITELCY  AN,  WHITEI_CY  AN))  error_exit(  1 ); 
add_shadow( ); 

wprintf("\n  Can  not  close  file"); 
wprintf('Vi  %s  ",  name); 

wprintf("\n  \n  Press  Esc  to  Continue"); 

wgetchf("’033’",0); 
wclose(); 


} 
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FUNCTION : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


error_einpty_ssn 

findcaid  in  link.c 

wopen 

error_exit 

wtitle 

add_shadow 

wprints 

wgetchf 

wclose 

4/12/90 

Rick  Howard 

Error  message  when  the  user  attempts  to  continue  a  lesson 
and  there  exists  no  students  in  the  linked  list 


Jit************ 


*********************************************************/ 


static  void  error_empty_ssn(void) 

{ 

if  ( !wopen(15,24,20,58,0,WHITEI_CYAN,WHITEI_CYAN))  enor_exit(l ); 
wtitle("[  Error  Window  ]",TCENTER,LGREENI_MAGENTA); 
add_shadow(); 

wprints(l,3,BLlNKIYELLOWI_BROWN,"No  students  are  in  the  list"); 
wprints(3,7,YELLOWI_BROWN, "Press  Esc  to  continue"); 
wgetchf("’\033”7Y’); 
wclose(); 

} 
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^*  ************************************************************* 


******** 


FUNCTION  : 

error_exit 

CALLED  BY: 

begin_lsn 

in  util.h 

confirm_quit 

in  util.h 

defnotebook 

in  util.h 

eiTor_close_file 

in  util.h 

error_empty_ssn 

in  util.h 

error_open_file 

in  util.h 

error_ssn 

in  util.h 

exams 

in  dmt.exe 

get_ssn 

in  link.c 

infomiation 

in  util.h 

logic_exam 

in  dmt.exe 

main 

in  calc.exe 

main 

in  lsn.exe 

main 

in  table.exe 

mainjmenu 

in  dmt.exe 

menudemo 

in  dmt.exe 

notebook 

in  dmt.exe 

open_back_wind 

in  dmt.exe 

open_notebook 

in  util.h 

open_titl_wind 

in  dmt.exe 

openwindow 

in  exam.exe 

pickdef 

in  util.h 

print_notebook 

in  dmt.exe 

quit_menu 

in  dmt.exe 

quit_menu 

in  lsn.exe 

tools 

in  dmt.exe 

view_notebook 

in  dmt.exe 

CALLS  : 

wprintf 

werrmsg 

exit 

MODIFIED  : 

4/12/90 

PERSON  : 

Rick  Howard 

PURPOSE  : 

Displays  an  appropriate  error  message  for  known  problems 

*********************************************************************** 
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static  void  error_exit(int  ermum) 

{ 

if(ermum)  { 

wprintf('Vi%s\n",(ermum==l)?wemnsg():error_textlermum]); 

exit(emium); 

I 

) 
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/*************************************************+******************** 


FUNCTION  : 
CALLED  BY: 


CALLS 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


error_open_file 

print jnotebook  in  dmt.exe 

view  .notebook  in  dnit.exe 

add_to_notebook  in  util.h 

wopen 

error_exit 

add_shadow 

wpruitf 

wgetchf 

wclose 


4/12/90 
Rick  Howard 

Error  messagee  if  the  system  can  not  properly  open  a  file 


*  *  *  *  **  *  **  »>  **  **  %  *  **  *  *  *  *  *  **  *  **  *  *  *  *  *  *  *  *  ***  *  **  *  **  *  *  if  %*  4<>fc  **  *  +  **  *  *****  *  * 

t 

static  void  error_open_fde(name) 
char  name[12]; 

I 

if  (!wopen(15,24, 19,57, 0,WHITELCYAN,WH1TELCY  AN))  error_exit(l ); 
add_shadow( ); 

wprintf("  Can  not  open  file"); 
wprintffVi  %s  ",  name); 

wprintf('Yi  Press  Esc  to  continue"); 
wgetchf("’M)33’",’Y’); 
wclose(); 


} 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


error_ssn 

get_last_lsn  in  util. h 

wopen 

error_exit 

add_shadow 

wprints 

wtitle 

wgetchf 

wclose 

4/12/90 

Rick  Howard 

Error  message  if  the  user  chosen  ssn  is  not  in  the  student 
linked  list 


!f!**>k*****j|<******!|<********  +  s|<*!|<*****!|<**!te**  +  ******l|r"t<*******i|<J(<**‘l<**>t'’l>*’l<*»l<>iy 


static  void  error_ssn(void) 

{ 

if  (!wopen(15.24,20,58,0,WHITELCYAN,WHITELCYAN))  error_exit(l ); 
wtitlen  Error  Window  ]",TCENTER,LGREENI_MAGENTA); 
add_shadow( ); 

wprints(  1 ,7,BLINKIYELLOWI_BROWN,"Can  not  find  that  SSN"); 
wprints(3,7,YELLOWI_BROWN,"Press  Esc  to  continue"); 
wgetchf ("  NO?  3  Y  ’ ); 

wclose(); 


} 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


get_last_lsn 

begin_lsn  in  util.h 

whelpcat 

init  ializej  inked_l  ist 

find_card 

error_ssn 

4/12/90 

Rick  Howard 

Reads  the  student  linked  list  in  from  a  file  and  looks 
for  a  specific  ssn 


fr**********************************************************************/ 


static  void  get_last_lsn(void) 

{ 

char  *ARGS[3];  /*  Placeholder  for  the  function:  find_card  */ 

int  page;  /*  Indicates  #  of  students  in  the  linked  list  */ 

int  start_lsn  =  TRUE;  /*  This  function  is  always  executed  at  the 

when  the  user  begins  a  lesson  */ 

whelpcat(H_SSN); 
initial  izeJinkedJistO; 

page  =  find_card(ARGS[l],  ARGS[2],  page,  start_lsn); 
if  (page  ==0){ 
error_ssn( ); 
return; 


156 


/************************************************,(,*+******************* 


FUNCTION  : 

infonnation 

CALLED  BY: 

initialize 

in  dmt.exe 

initialize 

in  lsn.exe 

CALLS  : 

whelpcat 

wmenubeg 

wmenuitem 

wmenuend 

wmenuget 

error_exit 

MODIFIED  : 

4/12/90 

PERSON  : 

Rick  Howard 

PURPOSE  : 

Defines  the  information  menu  structure 

*  ***  ******  **  ***  *  3*c  *  Ik  **  *  ******  ***********  1ft  ***  *  4C  a|t  9|c  4(  3|c  4e  4e  *  *  *  *  *  **  id  *  *  *  *  %  ****  %  *^ 


static  void  information(void) 

{ 

int  selection;  /*  The  user’s  menu  choice  */ 

wmenubeg(2.l3,6,26,0,YELLOWIJBLUE,YELLOWMBLUE,add_shadow); 
wmenuitem(0,0, "Definitions", ’D’,40,M_CLOSE,pickdef  ,0,H_DEF1NITIONS); 
wmenuitem(  1,0, "Examples", ’E’,41,0,do_nothing,0,H_EXAMPLES); 
wmenuitem(2,0,"Theorems",’T’,42,0,do_nothing,0,H_THEOREMS); 
wmenuend(40,M_PDIM_SAVE,0,l,YELLOW!_BLUE, 

LCYANI_BLUE,0,YELLOWI_LGREY); 


selection=wmenuget( ); 

if(selection==- 1  &&_winfo.ermo>W_ESCPRESS )  error_exit(  1 ); 
whelpcat(HJJSERJNTERFACE);  ~ 

} 
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/********************************************************************** 


FUNCTION : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


interface_bar 

menudemo  in  dmt.exe 

wopen 

wprints 

4/12/90 

Rick  Howard 

Displays  the  bottom  screen  help  bar  for  the  dmt  interface 


a**********************************************************/ 


static  void  interface_bar(void) 

{ 

char  help[]="H-Help"; 
char  exit|J="ESC-Back  up"; 

wopen(24,0.25,79,5,YELLOWI_BLUE,YELLOWIJBLUE); 
wprints(0,l  ,LCYANI_BLUE,help); 
wprints(0,68  ,LC  Y  AN  !_B  LUE,exit); 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


introduction_bar 
main  in  dmt.exe 
wopen 
wprints 
4/12/90 
Rick  Howard 

Displays  the  bottom  screen  help  bar  for  the  introduction 
screen  to  die  dmt  interface 


**  *******  ****  *  *  *  ***  *  *  ***  **  *  **  *  *  **  * 


static  void  introduction_bar(void) 

I 

chat  heIp[]="H-Help"; 
char  exitlJ="ESC-Quit"; 

wopen( 24 ,0,25, 79,5 ,YELLOW!_BLUE,YELLOWI_BLUE); 
wprints(0,l  ,LCYANI_BLUE,help); 
wprints(0,72,LCYANI_BLUE,exit); 

} 
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/*****************★*****★*****★*******************★******************** 


FUNCTION  : 
CALLED  BY: 

CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


normal_exit 

main  in  dmt.exe 

confinn_quit  in  dmt.exe 

srestore 

gotoxy 

showcur 

exit 


4/12/90 
Rick  Howard 

This  function  handles  normal  termination.  The  original 
screen  and  cursor  coordinates  are  restored  before  exiting 
to  DOS  with  ERRORLEVEL  0. 


static  void  normal_exit(void) 

I 

srestore(savescm); 
gotoxy  _(crow,ccol); 
showcurO; 
exit(0); 

) 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


open_notebook 

add_to_notebook  in  dmt.exe 

chgonkey 

wopen 

error_exit 

add_shadow 

wtitle 

winpbeg 

wprints 

winpdef 

winpread 

wputs 

wgetchf 

wclose 

findfirst 

strcmp 

fopen 

hidecurs 

error_exit 

4/12/90 

Rick  Howard 

Asks  the  user  for  his  notebook  name  and  sets  the  variable 
current_notebook  =  to  it. 


jfc:|<jft;|ea|c3fcjfej|c3ft:4c3f' 


************************************************************/ 


static  void  open_notebook() 

I 

stmct  ffblk  ffblk; 
struct  _onkey_t  *kl; 
int  done; 


/*  Place  holder  for  the  function  findfirst  */ 

/*  Pointer  to  current  hot-key  list  */ 

/*  Indicates  if  the  function  findfirst 
found  the  user’s  notebook  name  in  the 
current  directory  */ 


static  char  file_operation;  /*  Indicates  if  the  user  wants  to  append 

to  an  existing  notebook  file  or 
create  another  one  */ 


register  int  response;  /*  The  user’s  response 


V 
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/* 

Assign  the  current  hot  key  list  to  kl  and  set  the  current  hot 
key  list  to  NULL. 

*/ 

kl  =  chgonkey(NULL); 

/* 

Open  a  window  to  retrieve  the  user’s  notebook  name. 

*/ 

if( ! wopen(  10,8, 1 7,70, 1  ,LCY ANI_B LUE,  LCYANI_BLUE))  error_exit(l); 
add_shadow(); 

wtitle("[Name  Your  Personalized  Notebook}", TLEFT,  LCYANM3LUE); 

/*  Display  prompts  and  define  fields.  */ 
do  | 

winpbeg(LGREENI_LGREY,WHITEI_LGREY); 

wprints(  1.  3,  WHITEI_BLUE,  "Wliat  is  your  Notebook  Name?"); 
winpdefi  1,  35,  notebook_name,  "WWWWWWWW WWW", 0,0, NULL, 0); 
wprints(  3.  3,  WHITEI_BLUE,  "(A)ppend  or  (O)verwrite:"); 
winpdef(  3,  35,  file_operation,  ”<AaOo>”,0,0,NULL,0) ; 

/* 

Mark  end  of  form  and  process  it. 

V 

if(winpread())  break; 

if  (!wopen(15, 24,19, 57,0, WHITELCY  AN, WHITELCYAN))  error_exit(l ); 
add_shadow(); 

wputs('\i  Is  this  infonnation  correct?  V)33AN076YNb"); 
response  =  wgetchf("YN",’Y’); 

wclose(); 

) 

while  (response  !=  ’Y’); 

r 

Re-enable  the  hot-key  list. 

V 

chgonkey(kl ); 

/* 
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Look  for  die  user’s  notebook  file  in  the  current  directory. 

*/ 

done  =  findfirst(notebook_name,  &ffblk,  0); 

/* 

If  the  file  is  found  and  the  user  wishes  to  append  to  it,  open  the 
file  appropriately.  If  the  file  is  not  found  or  the  user  wishes  to 
overwrite  it.  open  it  appropriately. 

*/ 

if  (done  ==  0) 

if  ((strcmp(file_operation,"A")  ==  0)  II 
(strcmp(file_operation,"a")  ==  0)) 

current_notebook  =  fopen(notebook_name,  "a"); 

else 

currenl_notebook  =  fopen(notebook_name,  "w+t"); 
else 

current_notebook  =  fopen(notebook_name,  "w+t"); 

wcloseQ; 

hidecur(); 

} 
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I*  ***************** *************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


pickdef 

information  in  dmt.exe 

wopen 

error_exit 

add_shadow 

whelpcat 

wprintf 

wpickstr 

pre_pickl 

you_selected 

defnotebook 

4/12/90 

Rick  Howard 

Allows  the  user  to  choose  a  definition  from  a  list  of 
definitions  and  add  it  to  his  personalized  notebook 


static  void  pickdef(void) 

( 

int  def_number;  /*  Indicates  the  array  placement  of  the  user 
chosen  definition  */ 


/* 

OPen  a  window  for  the  definition  choices. 

*/ 

if( !  wopen(  10,11, 1 7 ,68 ,3  ,LMAGENT AI_RED,LREDI_MAGENTA))  error_exit(l ); 
add_shadow( ); 
whelpcat(H_S  ELECT); 

wprintf(”N033RM)01M)330003Select  a  definition  =>M)33R\001\033C\003"); 

/* 

Allow  the  user  to  choose  a  definition. 

*/ 

defjnumber  =  wpickstr(6,32,l  1  ,-1,0, 

LGREEN!_RED,LCYANI_RED,REDI_LGREY, 
definitions,0,pre_pickl ); 
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/* 

Show  the  user  the  definition  he  chose. 

*/ 

you_selected(definitions[def_number]); 

/* 

Give  the  user  the  option  to  add  the  definition  to  the  notebook  or 
print  it  out. 

*/ 

defnotebook(): 

wclosef); 

I 
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I** *************************** **** **************** *********** ********** 


FUNCTION  : 
CALLED  BY: 

CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


prejielp 

initialize 

main 

add_shadow 

setonkey 

4/12/90 


in  dmt.exe 
in  lsn.exe 


Rick  Howard 

Adds  a  shadow  to  all  help  screens 


static  void  pre_help(void) 

{ 

add_shadow(); 


/jfc********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


pre_pickl 
pickdef  in  util.h 
wmessage 
add_shadow 
4/12/90 
Rick  Howard 

Sets  up  the  window  for  shadow  and  borders 


static  void  pre_pickl(void) 

( 

wmessage("?  ?",BT_BORD,4,LGREENI_RED); 
add_shadow( ); 

} 


166 


/ft********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


press_a_key 

you_selected  in  util.h 

wcenters 

hidecurs 

waitJkey 

confinn_quit 

4/12/90 

Rick  Howard 

Displays  a  message  to  press  any  key  to  continue  and 
waits  for  the  user  to  follow  the  instruction. 


*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  **  %  *  *  *  *  *  *  *  %  *  %  *  *  %  *  %  *  *  %  *  %  *  %  *  %  *  *  *  %  %  %  *  *  *  %  *  *  *  *  *  %  *  *  *  tfj 


static  void  press_a_key(int  wrow) 

( 

register  int  attr;  /*  The  scrren  attribute  for  the  msg  window  */ 

attr=(BLINKIYELLOW)l((_winfo.active->wattr>>4)«4); 
wcenters(wrow,attr,"Press  a  key"); 
hidecur( ); 

if(waitkey()==ESC)  confirm_quit(); 
wcenters(wrow,attr,"  "); 

} 
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FUNCTION  : 
CALLED  BY: 

CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


quit 

quit_menu  in  lsn.exe 

save_position  in  link.c 

wcloseall 

printf 

exit 

4/12/90 
Rick  Howard 

Terminates  the  program  by  closing  all  windows,  clearing 
the  screeen  and  exiting  the  program 


static  void  quit(void) 

I 

wcloseallO; 

printf(CLR); 

exit(l); 

) 
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y?********************************************************************** 


FUNCTION  : 

logic_lsn 

CALLED  BY: 

begin_lsn  in  util.h 

CALLS  : 

execl 

MODIFIED  : 

4/12/90 

PERSON  : 

Rick  Howard 

PURPOSE  : 

Terminate  the  dmt.exe  program  and  execute  the  lsn.exe 
program 

♦t*************************************/ 


static  void  logic_lsn(void) 

I 

char  *args[l={ 

"lsn.exe", "logic.len", "logic.txt"  };  /*  The  command  line  for 

lsn.exe  program  */ 

execl("lsn.exe".args[0],args[l],args[2],NULL); 


/t************************************^******************************* 


FUNCTION  : 
CALLED  BY: 


CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


lsnbar 

main 

notebook 

tools 

wopen 

wprints 

4/12/90 


in  lsn.exe 
iii  lsn.exe 
in  lsn.exe 


Rick  Howard 

Displays  the  bottom  screen  help  window  for  any  lsn 


**********************************************************************/ 


static  void  lsn_bar(void) 

I 

char  helpU— ’H-Help"; 

char  find[J="ALT  P-Find  Page  #"; 

char  exit[]="ESC-Back  up"; 

wopen(24,0, 23,79, 5,YELLOWIJBLUE,YELLOWIJBLUE); 
wprinls(0,l,LCYANI_BLUE,help); 
wprints(0,3 1  ,YELLOW!_BLUE.find); 
wprints(0,68.LCYANi_BLUE,exit); 

} 
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/********************************************************************** 


FUNCTION  : 

top_bar 

CALLED  BY: 

menudemo 

in  dmt.exe 

main 

in  lsn.exe 

notebook 

in  lsn.exe 

tools 

in  lsn.exe 

CALLS  : 

wopen 

wprints 

MODIFIED : 

4/12/90 

PERSON  : 

Rick  Howard 

PURPOSE  : 

Displays  the  top  screen  help  window  for  the  interface 

***************************************************  Jlt******,,,***,,,.,,.,,,,,*,,,,,,.,,/ 

static  void  top_bar(void) 

I 

char  beginl  rj="B".begin2[]="egin"; 

char  information!  []="I",information2tJ="nformation"; 

char  exams  1  []="E",exams2[]="xams"; 

char  tools  1  U=  "T",tooIs2[]="ools"; 

char  notebook l[)="N",notebook2[]="otebook"; 

char  quit  J  |J="Q",quit2[J="uit"; 

wopen(0,0,2,79,0.YELLOWI_BLUE,YELLOWI_BLUE); 

wprints(0,2.LCYANI_BLUE, beginl ); 

wprints(0,3,YELLOWIJBLUE,begin2); 

wprints(0,l  2, LCYAJNIJBLUE, informat  ion  1 ); 

wprints(0,13,YELLOWI_BLUE,information2); 

wprints(0, 30.LCYANIJBLUE, exams  1 ); 

wprints(0.31.YELLOWIJBLUE.exams2); 

wprints(  0,42.  LC  Y  ANI_BLUE,tools  1 ); 

wprints(0,43.YELLOWI__BLUE,tools2); 

wprints(0,56,LCYAN!_BLUE, notebook  1 ); 

wprints(0,57,YELLOWl_BLUE,notebook2); 

wprmts(0,72,LC  VANI_BLUE,quit  1 ); 

wprints(0,73,YELLOWI_BLUE,quit2); 
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*  %  *  jfc  sf<  jfr  aje 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


you_selected 

pickdef  in  util.h 

wprintf 

wreadcur 

press_a_key 

4/12/90 

Rick  Howard 

This  function  is  used  by  the  List  Picking  demo  to  display 
a  selected  string,  or  display  an  error  message  if  an  error 
occurred.  It  also  prompts  the  user  for  a  keypress  2  lines 
below  the  string/error  message. 


******  Sit****************************************************************/ 


static  void  you_selected(char  *str) 

I 

int  wrow,wcol; 
if(_winfo.ermo) 

wprintf(’N033EL%s",werrmsg()); 

else 

wprintf("\f)33ELY ou  selected:  M)33Fv005%s\033F\004",str); 
wreadcur(&wrow,&wcol); 
press_a_key(wrow+2); 

} 
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APPENDIX  H 


THE  CODE:  FILE  "CALC.C" 


/********************************************************************** 


The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 

error_exit 

setonkey 

set_video 

wcclear 

wcenters 

wclear 

wgotoxy 

whelpdef 

whline 

wopen 

wprintf 

wscanf 

wshadow 

wslide 

wtitle 


DMT  Utilities 
CXL  Lib 
DMT  Utilities 
CXL  Lib 
CXL  Lib 
CXL  lib 
CXL  Lib 
CXL  Lib 
CXL  lib 
CXL  Lib 
CXL  Lib 
CXL  Lib 
DMT  Utilities 
CXL  Lib 
CXL  Lib 


PROGRAM  CALLS: 

NONE 

CALC  FUNCTIONS: 

displayjoop 

divv 

error_msg 

minus 

mult 

pre-help 

plus 

quit 

refresh 

table 
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COMPLETED:  4/12/90 


PERSONS:  Rick  Howard 


PURPOSE:  Provide  a  simple  four  function  calculator 


I***********#***************#******************************************/ 
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/*  header  fiJes  */ 


#include  <stdlib.h> 

#iiiclude  <math.h> 

#include  "d:\cxl\cxl%vin.h" 

#indude  "d:\c:  I\cxlkey.h" 

#include  "d:Vxl\cx1vid.h" 

#include  "d:Vxl\cxlstr.h" 

#include  "d:\tc\thesis\video.h" 

#include  "d:\tc\lhesis\help.h" 

I* _ *i 

I*  function  prototypes  */ 

static  int  chk_data_fld  (char  *input_field); 

static  void  confum_quit(void); 

static  unsigned  get_key(int  *done); 

static  void  quit(void); 

static  void  plus(void); 

static  void  minus(void); 

static  void  mult(void); 

static  void  divv(void); 

static  void  display _loop(void); 

static  void  error_msg(int  type); 

static  void  reset(void); 

static  void  refresh(void); 

static  void  table(void); 

static  void  pre_help(void); 

static  void  input(void); 

I* - */ 
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/*  constants  */ 


#define  INVALID_NUMBER  1 
#tlefine  INVALID_OPERATOR  2 
#clefine  RESET  1  .999 
#define  RESET2  .888 
#define  RESET3  "Q" 

#define  MAXNUM  10e36 
#define  MINNUM  10e-36 
#define  TRUE  1 
#define  FALSE  0 
#define  ZERODIV  0 
#define  BADOP  1 
#define  BAD_DATAJFLD  3 


/* 


*/ 


/*  globals  */ 

double  numl,  nuin2,  answer;  /* 

charop[Il;  /* 

char  numlstr[35],  num2str[35];  /* 

WINDOW  w;  /* 

int  i  =  0;  /* 

int  invalid_expression  =  0;  /* 

unsigned  key;  /* 

int  division_error  =  FALSE;  /* 


The  two  operands  and  the  result  */ 

The  operator  */ 

The  input  operands  */ 

The  window  handle  */ 

Counter  */ 

Used  to  determine  invalid  input  */ 

Define  alternate  keyboard  get  function.  */ 
Used  to  determine  division  by  zero  error  */ 
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I********************************************************************* 


FUNCTION : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 
Rick  Howard 
See  Declarations 


*********!*****>(<***>l‘**!fr********i(<*******>l<****>f<  +  ’f<’(<‘(<!ir**)fr’frlf'*]|':(<*if"*J)c***j|t*>l<*’ly 


main( ) 

I 

/* 

Check  for  mono,  CGA  or  EGA  screen. 

*/ 

set_video(); 


/* 

Set  up  the  hot-key  to  quit  the  program. 

*/ 

setonkey(0x01  IB,confirm_quit,0);  /*  ESC  */ 

/* 

Open  a  window  for  the  calculator. 

*/ 

if((w=wopen(2, 0,20,55, 3, WHITEI_CY AN, WHITEI_CYAN))==0) 
wprintf("error_exit(  I 

wtitleflDMT  Calculator]",TCENTER,  WHITEI_CY  AN); 

wmessage("|ESC-OUIT]",BT_BORD,4,YELLOWLCYAN); 

wmessage( "  |  H-HELP  ,BT JB  ORD  ,45  ,Y  ELLO  WI_C  Y  AN); 

wshado  w(  LGREYI_B  LACK ); 

wslide(2,25); 

wslide(2,10); 

I* 

Define  the  help  screen  attributes. 

*/ 

whelpdef("DMT.HLP", 0x2368, BLACKI_LGREY.BLACKI_LGREY, 

LB  LUEI_LG R E Y . LREDI  LGREY.preJielp); 
whelpcat(H_CALCULATOR_HELP); 
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while  (1 )( 


/* 

Initial  set  up. 

*/ 

invalid_expression  =  FALSE; 
wcclear(  WHITEI_CY  AN ); 

/* 

Accept  input  from  the  user. 

*/ 

input(); 

/* 

Perform  the  appropriate  calculation  based  upon  the  operator. 

*/ 

switch  (*op){ 
case 
plus(); 
break; 
case 
minusQ: 
break; 
case 
mult(); 
break; 
case 
divv(); 
break; 
default: 

error_msg(BADOP); 

I 
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/* 

Check  for  division  error  and  continue. 

*/ 

if  (division_error  ==  FALSE)! 
whelpcat(H_CALC7); 

wcenters(I5,YELLOWI_LGREY, "Press  any  key  to  continue"); 
waitkey( ); 

I 

refreshf); 

) 


179 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


quit 

calc 

exit 

wcloseall 

clrscr 

4/12/90 

Rick  Howard 

Terminates  the  program 


i**********************************************************************/ 


static  void  quit(void) 


wcloseallO; 

^irscrO; 

exit(0); 

) 


a********************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


plus 

calc 

wprintf 

table 

gotoxy 

4/12/90 

Rick  Howard 

Performs  the  addition  operation  on  both  operands  and  displays 
the  results. 


********************************* **:M**********************************/ 

static  void  plus(void) 

I 

wgotoxy(6,5); 
answer  =  num  1  +  num2; 
wprintf("%30.2f",  answer); 
table(); 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


minus 

calc 

wprintf 

table 

got  ox  y 

4/12/90 

Rick  Howard 

Performs  the  subtraction  operation  on  both  operands 
and  displays  the  results. 


Jlc*********************************************************************^ 


static  void  minus(void) 


wgotoxy(6,5); 
answer  =  num  1  -  num2; 
wprintf("%30.2f",  answer); 
table( ); 


^l(<**  +  *j(<*  +  l(c***  +  j(t*j(t****lKl(<*l(tJ<<l(<*!(<j|<*******l(<**>('**1ttll'1('>('***************!(t*****j(<* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


mult 

calc 

wprintf 

table 

gotoxy 

4/12/90 

Rick  Howard 

Performs  the  multiplication  operation  on  both  operands 
and  displays  the  results. 


**i|<***i|<*i|<  +  *i((****  +  **i(<***!!<******  +  ********#***>)<****  +  +  **>l<*J|e**>l<>l<*>l<’f'>l<*>l<!|<>|e>|fl|<i|y 


static  void  mult(void) 

( 

wgotoxy(6,5); 
answer  =  num  I  *  num2; 
wprintf("%30.2f',  answer); 
table( ); 
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^t********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


divv 

culc 

wprintf 

table 

gotoxy 

4/12/90 

Rick  Howard 

Performs  the  division  operation  on  both  operands 
and  displays  the  results. 


static  void  divv(void) 

I 

wgotoxy(6,5); 
if  (num2  ==  0.0) 

error_msg(  ZERODIV ); 
else 
( 

reset(); 

Hiswer  =  numl  /num2; 
wprintf("%30.2f,  answer); 
table(); 


I 
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^/* ********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


error_nisg 

calc 

wcenters 

wopen 

wprintf 

wshadow 

whelpcat 

waitkey 

wclose 

4/12/90 

Rick  Howard 

Displays  an  error  message  for  any  recognized  invalid 
expression. 


********************************************************************** 


static  void  eiTor_nisg(int  type) 

I 

int  ch;  /*  Holds  user  input  */ 

/* 

Open  error  window. 

*/ 

it(!wopen(13.20,17,53.0,WHITEI_RED,WHITELRED))wprintf(,,error_exit(l)''); 
wshadow(DGRE  Y  l_B  LACK ) ; 


switch  (type)( 
case  0: 

whelpcat(H_CALC6); 

weenters(0,BLlNKIWHITEI_RED, "Division  By  Zero"); 
break; 
case  1: 

whelpcat(H_CALC8); 

wcenterstO.BLINKIWHITEI_RED, "Invalid  Operator" ); 
break; 
case  3: 

whelpcat(H_CALC9); 

wcenters(O.BLINKIWHITE!_RED, "Invalid  Data  Field  Entry"); 
break; 
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default: 

break; 

} 

/* 

Wait  for  the  user’s  response. 

*/ 

wcenters(2,WHITEI_RED, "Press  any  key  to  continue"); 

clearkeys(); 

waitkeyO; 

division_error  =  TRUE; 
wclosef); 

} 
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FUNCTION  : 
CALLED  BY: 


CALLS 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


table 

plus 

minus 

divv 

mult 

wgotoxy 

wprintf 

whline 

4/12/90 

Rick  Howard 

Displays  the  two  operands,  the  operator  and  the  solution 
in  a  nice  tabular  format. 


fc*******************************************************************/ 


static  void  tablet  void) 

I 

division_error  =  FALSE; 

wgotoxy(3,5); 

wprintf("%30.2f',numl ); 

wgotoxy(4,5); 

wprintf("%30.2f',num2); 

wgotoxy(4,40); 

wprintf("%c".*op); 

whline(5,12,25,0,BLACKI_CYAN); 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


reset 

calc 

NONE 

4/12/90 

Rick  Howard 

Resets  the  error  indicator  booleans 


*********************** ****** *****************************************/ 


static  void  reset(void) 

I 

division_error  =  FALSE; 
invalid_expression  =  FALSE; 

) 


jUt  *************** 


****************************************************** 


FUNCTION : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


refresh 

calc 

wclear 

wgotoxy 

4/12/90 

Rick  Howard 

Clears  the  calculator  window. 


********************************************************************** 
static  void  refresh() 

I 

wclear(); 
wgotoxy(  15,5); 

} 
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^**********************************************>l<,l<**,l,**.lc**************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


prejielp 

calc 

wshatlow 
4/12/90 
Rick  Howard 

Adds  a  shadow  to  the  help  screen  and  sets  a  hot-key  that 
allows  the  user  to  quit  the  program. 


*  *  *  *  *  %  *  *  *  *  *  *  **  *  *  *  *  *  *  *  %  *  *  *  *  %  *  *  *  *  *  %  *  *  *  *  *  *  *  *  *  %  *  *  *  *  *  *  *  *  *  %  *  *  *  %  *  %  >|c  *  **  *  *  %  *  %  i|i  *  j 


static  void  pre_help(void) 

I 

wshadow(LGREYMBLACK); 

setonkey(0x2d00,quit,0); 

I 
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************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


input 

calc 

wshadow 

wopen 

wprintf 

wtitle 

wmessage 

winpbeg 

wprints 

winpdef 

winpkey 

winpread 

wputs 

wgetchf 

cvtcf 

wclose 

4/12/90 

Rick  Howard 

Allows  the  user  to  input  numbers  for  calculations. 


a**********************************************************************/ 


static  void  input(void) 

I 

register  int  ch;  /*  Holds  user  input  */ 

register  int  mode=0;  /*  Toggles  data  field  category  */ 

/* 

Open  a  window  for  the  input. 

*/ 

if(!wopen(4,17,18,57,l,LCYANI_BLUE,LCYANI_BLUE))  wprintf("error_exit(l)"); 
wshadow(DGREYI_BLACK); 

wtitle("[  Calculator  Input  Pad  ]'\TCENTER,LCYANIJBLUE); 
wmessagef  lF10]=Calculate  ",BT_BORD,  12,LCYANI_BLUE); 
do  | 

/* 

Mark  beguuring  of  fomi. 

V 

winpbeg(LGREENLLGREY,WHITELLGREY); 
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/* 

Display  prompts  and  define  fields. 

*/ 

wprints(2,5.WHITELBLUE, "First  Number"); 

winpdef(2, 20, numlstr, "999999999. 99", ’9’, mode, chk_data_fld,H_CALCl); 


wprints(4,5,WHITEI_BLUE, "Operator"); 
winpdef(4, 20  ,op, "<*+/->", 0, mode, NULL, H_CALC2); 

wprints(6,5,WHlTEIJBLUE,"Second  Number"); 

winpdef(6.20,num2str, "999999999.99", ’9’, mode, chk_data_fld,H_CALC3); 
/* 

Define  alternate  keyboard  get  function. 

*/ 

winpkey(get_key,&key); 

/* 

Mark  end  of  fonn  and  process  it.  If  [Esc]  was  pressed, 
then  don’t  bother  with  the  confinnation  message. 

*/ 

if(winpread())  break; 

/* 

Display  confinnation  message. 

*/ 

if(!wopen(  1 3 ,20, 1 7,53,0,WHITELCYAN, 

WHITEI_CY AN))  wprintf("error_exit(  1 )" ); 
wshadow(DGREYI_BLACK); 
wputs("\u  Is  this  infoniialion  correct?  M)33A\076Y\b"); 
clearkeysO; 
whelpcat(H_CAi_.C4); 
ch=wgetchf("YN",’Y’); 
wclose(); 

/* 

Change  field  mode  to  "update". 

*/ 

mode=l; 


) 

while(ch!=’Y’); 
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/* 

Convert  the  input  operand  strings  to  floats. 

*/ 

numl  =  cvtcf(nuinlstr,G.2); 
num2  =  cvtcf(num2str,9,2); 

/* 

Close  the  input  window. 

*/ 

wclose(); 

} 
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y*  ********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


confirm_quit 

calc 

chgonkey 

wopen 

wpriiitf 

wshadow 

wputs 

clearkeys 

whelpcat 

wgetchf 

wclose 

4/12/90 

Rick  Howard 

Allows  the  user  the  option  to  quit  the  program  or 
continue  where  he  left  off. 


************** 


********************************************************/ 


static  void  confirm_quit(void) 

( 

struct  _onkey_t  *kblist;  /*  Pointer  to  the  list  of  active  hot-keys  */ 
/* 

Save  the  hoy-key  list  in  kblist  and  set  the  active  list  to  NULL. 

*/ 

kblist=chgonkey(NULL); 

/* 

Open  a  message  window. 

*/ 

if(!wopen(  1 4.22, 1 8 ,5 1 ,0,WHITEI_BROWN, 

WHITEI_BROWN))  wprintf("error_exit(l )"); 
wshadow(LGREYI_BLACK); 
wputs("\n  Quit,  are  you  sure?  \033A\156Y''b"); 


191 


/* 

Accept  die  user’s  choice. 

*/ 

clearkeysO; 

whelpcat(H_CALC5); 

if(wgetchf("YN",’Y')==’Y’)quit(); 

wclose(); 

/* 

Reset  the  active  hot-key  list. 

*/ 

chgonkey(kblist); 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


chk_data_fkl 

calc 

error_msg 
4/12/90 
Rick  Howard 

Checks  data  strings  for  valid  input 


s********************************************************************** 


static  int  clxk_data_fld  (char  *input_field) 

{ 

bit  num_plus=0.num_nimus=0:  /*  Holds  the  number  of  operators  in  the 

input  string  */ 

bit  current_position=l  ,error_position=0;  /*  Keeps  track  of  position  of 

the  error  bi  the  biput  string  */ 

int  error_flag  =  FALSE;  /*  Indicates  if  an  error  was  found  */ 

/* 

Search  for  end  of  text. 

*/ 

whi]e(*input_field++!-’  ’)  current_position++; 

/* 

Search  for  the  begining  of  the  strbig. 

*/ 

while(*input_field  ==  ’  ’) 
biput_field++; 
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Checks  for  multiple  ’+’  or  signs. 
*/ 

while  (*input_field  !=  T\0’){ 

if  (*input_field  ==  ’+’){ 
num_plus++; 
if  (cuirent_position  >  1) 
error_flag  =  TRUE; 

) 

if  (*input_field  == 
num_minus++; 
if  (current  posit’on  >1) 
error_flag  =  TRUE; 

I 

input_field++; 

current_position++; 


if  more  thaji  on.  plus  or  minus  return  error 

*/ 

if((num_plus  >  1)  II  (num_minus  >  1)  II  (error_flag))( 
error_msg(BAD_DATA_FLD); 
retum(l); 

) 

else 

retum(O); 

) 
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APPENDIX  I 


THE  CODE:  FILE  "LINK.C" 

^*  *****+**************+******************+**********+*****************+* 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 

LIBRARY  CALLS: 


execl 

Turbo  C  Lib 

fclose 

Turbo  C  Lib 

terror 

Turbo  C  Lib 

fgets 

Turbo  C  Lib 

fopen 

Turbo  C  Lib 

fprintf 

Turbo  C  Lib 

free 

Turbo  C  Lib 

itoa 

Turbo  C  Lib 

malloc 

Turbo  C  Lib 

printf 

Turbo  C  Lib 

puts 

Turbo  C  Lib 

strcmp 

TURBO  C  Lib 

strcpy 

Turbo  C  Lib 

strtlup 

Turbo  C  Lib 

strlen 

Turbo  C  Lib 

wclose 

CXL  Lib 

winputsf 

CXL  Lib 

wopen 

CXL  Lib 

wtitle 

CXL  Lib 

PROGRAM  CALLS: 

lsn.exe 
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LINK  FUNCTIONS: 

add_card 

add_shadow 

error 

error_exit 

find_card 

get_ssn 

initialize_liiiked_list 

insert_node 

list_cards 

prt_record 

read_fde 

write  file 


COMPLETED: 

PERSONS: 

PURPOSE: 


4/12/90 

Rick  Howard  (  Liberally  borrowed  code  from  Augie 
Hansen’s  book,  "C  Programming:  A  Complete  Guide 
to  Mastering  the  C  Language".) 

Provides  all  the  functionality  to  maintain  a  linked  list. 


4c****ift*******!|<**********%**i|<***>t'’l'***It'****><'*1l'****It',l‘Il<’('****’<<Il>ll'>l'’l’’l'********>iy 


196 


/*  header  files  */ 


#include  <stdio.h> 

#indude  <stdlib.h> 

#include  <string.h> 

/* - */ 

/*  Type  Definitions  */ 

typedef  struct  card_st{ 
char  ssn|SSNSIZEJ; 
char  lsnlengt  h[  LS  N_LEN GTH_S  IZE] ; 
char  lsn_name[LSN_NAME_SIZEJ; 
char  lsn_page_numlLSN_PAGE_NUM_SIZE]; 
struct  card_st  *next; 

I 

CARD; 

CARD  listliead.  *head,  *current; 

/* . .  . . */ 


/*  function  prototypes  */ 

static  void  get_ssn(char  bufllO]); 
static  int  initialize_linked_list(); 

static  int  add_card(char  ssan[SSNSIZE],  char  bufl  f LSN_LENGTH_SIZE] , 
char  buf2[LSN_NAME_SIZE|,  int  page); 
static  int  find_card(char  bufl  [LSN_LENGTH_SIZE], 

char  buf2lLSN_NAME_SIZEJ,  int  page,  int  startjsn); 
static  int  read_file(char  *); 
static  int  write_file(char  *); 
static  CARD  *insert_node(CARD  *); 
static  void  error(char  *); 

static  void  prt_record(char  *,  char  *,  char  *,  char  *); 
static  int  list_cards(void); 

/* _ *j 
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/************************************* ********************************* 


FUNCTION  : 
CALLED  BY: 

CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


initial  ize_linked  J  ist 

save_position  from  the  dmt.exe  program 

get _last_lsn  from  the  lsn.exe  program 

read_file 

error 

4/12/90 

Rick  Howard 

Read  the  student  information  file  into  a  linked  list 
for  manipulation. 


**********************************************************************/ 


static  int  initialize_linked_list() 

I 

int  rc;  /*  Indicates  an  error  after 

execution  of  the  read_file 
function  */ 

/*  Tire  name  of  the  student 
infonnation  file  */ 

static  char  data_file[NBYTES  -+-!)={ 

’’cardfile.dat’’ 

); 


/* 

Set  up  the  linked  list  pointers. 

*/ 

current  =  head  =  &listhead; 
head->next  =  head; 

/* 

Read  the  student  information  file  into  the  linked  list. 

*/ 

rc  =  read_file(data_file ); 
if  (rc) 

error("Cannot  read  data  file"); 
return  EXIT_SUCCESS; 
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/*  *************  *****************>|<*>|.*****1|<******,|,,|«  ************,(,,!,******,,,,,< 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


acld_card 

find_card 

inseilnode 

fpriiitf 

strcpy 

itoa 

4/12/90 
Rick  Howard 

Adds  a  student  to  the  linked  list 


*** ******************** * **** * * * * * * * ***** * * * * * ****** * * * *** * * * ***** + *** 


static  int  add_card(char  ssan[SSNSIZEl.  char  buf  I  [LSN _LENGTH_SI7 T] , 
char  buf2lLSN_NAME_SIZEJ,  int  page) 

I 

CARD  *tmp;  /*  Pointer  to  the  newly  created  node  in  the 

linked  list  */ 


/* 

Create  a  new  node  in  the  linked  list. 

*/ 

tmp  =  insert_node(current); 
if  (tmp  ==  NULL){ 

fprintf(stderr,  "Out  of  memory"); 

} 

/* 

Place  the  student  information  into  the  new  node. 

*/ 

else  { 

current  =  tmp; 
strcpy(current->ssn,  ssan); 
strcpy(current->lsn_length,bufl); 
strcpy(current->lsn_name,buf2); 
itoafpage,  current->lsn_page_num,10); 

) 

return  0; 

I 
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FUNCTION  : 
CALLED  BY: 

CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


find_card 

save_position  from  the  program  1sn.exe 

get_last_lsn  from  the  program  dmt.exe 

error_empty_ssn 

get_ssn 

strlen 

trncmp 

strcpy 

itoa 

free 

add_card 
execl 
4/12/90 
Rick  Howard 

Locates  a  student  in  the  student  information  file 


static  int  find_card(char  bufl  [LSN_LENGTH_SIZE], 

char  buf2lLSN_NAME_SIZEJ,  int  page,  int  start_lsn) 


I 

int  rc  =  0; 
int  hits  =  0; 
int  Ien; 
char  *cp; 
CARD  *tmp; 

chat  ssan[10J; 


/*  Indicates  an  error  inside  the  list  */ 

/*  Indicates  if  the  student  was  found  in  the  list  */ 

/*  Number  of  characters  in  a  SSN  */ 

/*  Points  to  the  SSN  field  in  the  tmp  structure  */ 

/*  Holds  the  information  that  needs  to  be  found  in 
the  linked  list  */ 

/*  Holds  the  SSN  of  the  of  the  student  to  be  found 
in  the  linked  list  */ 
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/*  Place  holders  for  the  command  line  to  call  the 
lsn.exe  program  */ 

char  *cmds|J  =  { 

NULL, 

NULL, 

NULL, 

NULL, 

NULL 

}; 

/* 

Set  the  tmp  structure  equal  to  the  front  of  the  list. 

*/ 

tmp  =  head; 

if  ((tmp->next  ==  head)  &&  (start_lsn  ==  TRUE))  { 
error_empty_ssn( ); 
return  ++rc; 

} 

/* 

Retrieve  the  user’s  SSN. 

*/ 

get_ssn(&ssan); 
len  =  strlen(ssan); 


/* 

For  each  item  in  the  linked  list... 

*/ 

while  (tmp->next  !=  head){ 
tmp  =  tmp->next; 
cp  =  tmp->ssn; 
while  (*cp  !=  N0’){ 

/* 

If  the  user’s  SSN  matches  the  record’s  SSN.... 

*/ 

if  (stmcmp(cp,ssan,len)  ==  0){ 
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/* 

If  this  is  not  the  begining  of  a  lesson,  copy 
the  user’s  information  into  the  tmp  structure. 

*/ 

if  (start_lsn  ==  FALSE)! 

strcpy(tmp->lsn_length,buf  1 ); 

strcpy(tnip->lsn_name,buf2); 

itoa(page,tmp->lsn_page_num,10); 

) 

/* 

If  this  is  the  begining  of  a  lesson,  copy  the 
user’s  information  into  the  command  line  structure. 

*/ 

else  { 

if  (cmds|2]  !=NULL) 
free(cmds|2|); 

cmds[2J  =  strdup(tmp->lsn_length); 
if  (cmds[3J  !=  NULL) 
free(cmds[3J); 

cmds[3J  =  strdup(tmp->lsn_name); 
if  (cmds[4]  !=NULL) 
free(cmds[4J); 

cmdsl4J  =  strdup(tmp->lsn_page_num); 

I 

++hits; 

} 

++cp; 

) 
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if  ((hits  ==  0)  &&  (startjsn  ==  0)) 
add_card(ssan,bufl,  buf2,  page); 

else  if((hits  ==  0)  &&  (startjsn  ==  1)) 
return  hits; 

else  if  (startjsn ){ 
cmds|0J  =  "lsn.exe"; 
cindsfl]  =  "lsn.exe"; 

execl(cmds[0],cmds[l],  cmdst2],  cmds[3],cmds[4],NULL); 

} 

return  rc; 
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********************************************************************* 


/* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


list_cards 

NONE(Debugging  Utility) 
puts 

pil_record 
4/12/90 
Rick  Howard 
Prints  the  linked  list 


****************************************  ******************************  iiy 


static  int  Iist_cards(void) 

I 

int  rc;  /*  Indicates  an  empty  list  */ 

CARD  *tmp;  /*  A  temporary  student  information  record  */ 
/* 

Set  the  tmp  student  record  equal  to  the  head  of  the  linked  list 
and  check  for  errors. 

*/ 

tmp  =  head; 
if  (tmp->next  ==  head){ 
puts("List  empty"); 

++rc; 

) 

/* 

For  each  record  in  the  list.. .print  the  record 

*/ 

else 

while  (tmp->next  !=  head){ 
tmp  =  tmp->next; 

prt_record(tmp->ssn,  tmp->lsn_length,tmp->lsn_name, 
tmp->lsn_page_num); 

} 

return  rc; 

) 
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FUNCTION  : 

error 

CALLED  BY: 

initial  ize_linked_list 

read_file 

write_file 

CALLS  : 

fprintf 

exit 

MODIFIED  : 

4/12/90 

PERSON  : 

Rick  Howard 

PURPOSE  : 

Print  an  error  message  in  the  linked  list  file 

void  eiTor(char  *inesg) 

{ 

fprintf(stderr,  "Error:  %s\n",  mesg); 
exit(EXIT_FAILURE); 

} 
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/fr********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


read_file 

initialize_linked_list 

fopen 

fgets 

inseit_node 

error 

strcpy 

ferror 

4/12/90 

Rick  Howard 

Read  the  student  information  file  into  a  linked  list 


*******************************************!4<!|<****S(t***********>!t!|<!|<>|<*l|<*l|<!|<>iy 

static  int  read_file(char  *fname) 

I 

char  *cp;  /*  Used  to  read  data  into  a  buffer  */ 

FILE  *lp;  /*  Pointer  to  a  file  */ 

char  linelNBYTES  +1];  /*  Used  to  read  data  into  a  buffer  */ 

int  rc  =  0;  /*  Holds  the  return  value  of  the  function  */ 

CARD  *tmp:  /*  Temporary  storage  of  the  data  template  */ 

/* 

Open  the  file  for  reading. 

*/ 

fp  =  fopen(fname,  "r"); 
if  (fp  ==  NULL) 
return  0; 


/* 

Read  the  data  into  a  buffer. 

*1 

while  (fgets(line,  NBYTES  +  1,  fp)  !=  NULL){ 
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Remove  NL. 


/* 

*1 

cp  =  line; 

while  (*cp  !=  ’Nn’  &&  *ep  !=  ’MJ') 

++cp; 

*cP  =  ’'O'; 

/* 

Allocate  a  node  and  point  to  it. 

*/ 

tmp  =  insert_node(current); 
if  (tmp  ==  NULL) 

error("out  of  memory"); 
current  =  tmp; 

/* 

Copy  data  to  card  structure. 

*/ 

strcpy(current->ssn,  stilok(line, 
strcpy(current->lsn_lenpth,stnok(NULL,  "\i" )); 
strcpy(current->lsn_name,  strtok(NULL.  ’V’)); 
strcpy(current->lsn_page_num,  strtok(NULL,  ”\t")); 

) 


Close  the  file. 

*/ 

fclose(fp); 
if  (ferroi(fp)) 

error("Cannot  close  data  file"); 
return  rc; 
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FUNC1  ION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


write_file 

save_position  in  the  program  lsn.exe 

fopen 

fprintf 

puts 

fclose 

ferror 

error 

4/12/90 

Rick  Howard 

Write  the  linked  list  into  the  student  information  file 


static  int  write_file(char  *fname) 

I 

FILE  *fp;  /*  File  pointer  */ 

int  rc  =  0;  /*  Holds  the  return  value  of  the  function  */ 

CARD  *tmp;  /*  Temporary  storage  for  the  data  template  */ 

/* 

Open  the  file  for  reading. 

*/ 

fp  =  fopentfname,  "w"); 
if  (fp  ==  NULL)( 

fprintf(stderr,  "Cannot  open  %s\n",  fhame); 
return  ++rc; 

I 


208 


Write  the  data  into  a  buffer. 


/* 

*/ 

tmp  =  head; 

if  (tmp->next  ==  head)j 
puts("List  empty"); 

++rc; 

I 

else 

while  (tmp->next  !=  head){ 
tmp  =  tmp->next; 

fprintfffp,  "%sNt%sM%s\t%s\n",  tmp->ssn,  tmp->isn_length, 
tmp->lsn_name,  tmp->lsn_page_num); 

) 


/* 

Close  the  file 

*/ 

fdose(fp); 
if  (ferror(fp)) 

error("Caiuiot  close  data  file"); 
return  rc; 

I 
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/**%%****************************************************************** 


FUNCTION  : 
CALLED  BY: 

CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


insert_node 

add_card 

initial  ize_linked_list 

malloc 

4/12/90 

Rick  Howard 

Inserts  a  blank  node  into  the  linked  list 


**********************  I************ **************************** *********/ 


CARD  *  insert_node(CARD  *listp) 

I 

CARD  *new; 


new  =  (CARD  *)  malloc(sizeof(CARD)); 
if  (new  !=  NULL){ 

new->next  =  listp->next; 
listp->next  =  new; 

} 

return  new; 

} 
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^*  ********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


prt_record 
list_cards 
printf 
4/12/90 
Rick  Howard 

Prints  one  record  in  the  linked  list 


if******************************************************/ 


static  void  prt_record(char  *sl,  char  *s2,  char  *s3,  char  *s4) 

{ 

printf("%-*sM%-*sV%-*sV%-*s\n",  SSNSIZE,  si,  LSN_LENGTH_SIZE,  s2, 
LSN_NAME_SIZE,  s3,  LSN_PAGE_NUM_SPE, 


s4); 


} 
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/A********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


get_ssn 

fiml_card 

wopen 

error_exit 

wtitle 

add_shadow 

winputsf 

wclose 

4/12/90 

Rick  Howard 

Retrieve  die  user’s  SSN 


ft*********************************************************************/ 


static  void  get_ssn(char  buf[10]) 

{ 

/* 

Open  a  window. 

*/ 

if(!wopen(5  2U5.58,3,LGREENI_MAGENTA,LGREENLMAGENTA)) 
error_exit(l); 

wtitlefl  Enter  Social  Security  Number  ]",TCENTER,LGREENI_MAGENTA); 
add_shadow( ); 

/* 

Get  the  user's  SSN. 

*/ 

if(winputsf(buf,’”\nVi  Soc  Sec  Number?  MR-!" 

"<0 1 234567>##!-!’- ’!+!##!-!  ’-’!+!####"))  quit(); 

wclose(); 


) 
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APPENDIX  J 


THE  CODE:  FILE  "TXTMOD.C" 


/*********************************************************************** 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


FILENAME:  txtmod.c 
LIBRARY  CALLS: 


exit 

Turbo  C  Lib 

fcloseall 

Turbo  C  Lib 

fopen 

Turbo  C  Lib 

fputs 

Turbo  C  Lib 

fwrite 

Turbo  C  Lib 

getc 

Turbo  C  Lib 

printf 

Turbo  C  Lib 

puts 

Turbo  C  Lib 

strcat 

Turbo  C  Lib 

strcpy 

Turbo  C  Lib 

strtok 

Turbo  C  Lib 

PROGRAM  CALLS: 

NONE 

TXTMOD  FUNCTIONS: 

pageclr 

COMPLETED:  4/12/90 

PERSONS:  Keith  Calcote 

PURPOSE:  Corvert  an  ASCII  file  into  a  format  that  can  be  displayed 

as  a  lesson  in  the  dmt.exe  program 
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/*  header  files  */ 


#include  <stdio.h> 

#include  <string.h> 

#include  <sldlib.h> 

#include  <process.h> 

/* - */ 


/*  Constants  */ 

#define  PAGEL  2000  /*  total  number  of  chars  per  page  */ 
#define  NUMLFS  19  /*  number  of  lines  per  page  */ 

#define  LEN  50  /*  number  of  pages  in  the  tutor  */ 

#define  ZEOF  VIA’ 

#define  FFEED  VOC’ 

#define  LFEED  VO  A’ 

#define  CLR  printf("\xlB[2J") 

/* - : - */ 


/*  globals  */ 
char  page  [PAGEL]; 

/* . */ 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 
Keith  Calcote 
See  Declarations 


*  *  *  *  * + *  *  *  *  *  *  *  *  *  *  * + *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  ★  *  *  *  %  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  +  % + *  >)■  * 


main(int  argc,  char  *argv[]) 
{ 


int  ch; 

/* 

Temporary  character  storage 

int  loop=0,  dex=0 ; 

/* 

Counters 

7 

int  lincnt  =  1  ; 

/* 

Number  of  lines 

7 

int  pgnum  =  1  ; 

/* 

Number  of  pages 

7 

int  wordcnt  =  0  ; 

/* 

Number  of  words 

7 

FILE  *fptrl  ; 

/* 

Input  file  poin‘er 

7 

FILE  *fptr2  ; 

/* 

Output  file  pointer 

7 

FILE  *fptr3  ; 

/* 

Length  file  pointer 

7 

int  length[LEN]  ; 

/* 

Contains  the  number  of  bytes  per  page 

char  *chptr ; 

1* 

Temporary  character  storage  pointer 

char  lenptr[15]  ; 

1* 

Temporary  file  name  storage 

char  outputll5]  ; 

/* 

Temporary  file  name  storage 

/* 

Clears  the  screen 

7 

CLR  ; 
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Error  check. 


/* 

*/ 

if(argc  !=  3) 

I 

putsC'Format  is:  txtmod  inputfile  outputfile.") ; 
puts("The  outputfile  will  have  the  extention  .txt .") ; 
puts("A  length  file  will  be  generated  with  the  same  name") ; 
puts("as  the  output  file  and  will  have  an  extention  .len  .") ; 
exit(O) ; 


/* 

Forces  the  output  file  to  have  an  extension  of  ".txt"  and  forces 
the  length  file  to  have  the  same  prefix  with  die  ".len"  extension. 

*/ 

chptr  =  strtok(argv|2],".") ; 
strcpy(output,chptr) ; 
strcpy(lenptr,chptr) ; 
strcat(output.".txt") ; 
strcat(lenptr,".len") ; 

/* 

Display  the  name  and  identification  of  each  file. 

*/ 

printf( "Input  file:  %s\n",argv[l]) ; 
printf("Output  file:  %s\n", output) ; 
printf(”Length  file:  %sV',lenptr) ; 

/* 

Open  the  files. 

*/ 

if(  (fptrl=fopen(argv[lJ,"rb"))  ==  NULL  ) 

{ 

printffCANT  OPEN  FILE  %s  ",argv[l]); 
exit(O); 

I 

if(  (fptr2=fopen(output,"wb"))  ==  NULL  ) 

I 

printffCANT  OPEN  FILE  %s  ".output); 
exit(O); 

) 
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if(  (fptr3=fopen(lenptr,"wb"))  ==  NULL  ) 

( 

printf("CAN’T  OPEN  FILE  %s",lenptr); 
exit(O); 


/* 

Counts  and  stores  the  number  of  bytes  per  page. 

V 

paged r() ; 

cli  =  getc(fptrl )  ; 

whUe  ( (ch  !=  ZEOF)  &&  (ch  !=  EOF) ) 

( 

/* 

Prevents  pages  from  being  greater  than  the  maximum  number 
of  lines  per  page. 

*/ 

if(  linent  >=  NUMLFS  ) 

I 

linent  =  l  ; 
fputs(page,fptr2) ; 
pgnum  ++ ; 

length[pgnum]  =  wordent ; 
pageclrO  ; 
dex  =  0  ; 


/* 

Start  a  new  page 

*/ 

if  (ch  ==  FFEED) 

I 

ch  =  LFEED  ;  /* 


when  a  fonn  feed  is  encountered. 


change  ch  to  L/F  */ 
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/* 

Adds  line  feeds  so  that  each  page  has  the  same  number  of 
lines. 

*/ 

for(loop  =  lincnt  +  1;  loop  <=  NUMLFS;  loop++) 

{ 

page[dex]  =  ch  ; 
dex  ++  ; 
wordcnt  ++  ; 

) 

lincnt  =  0  ; 
fputs(page,fptr2) ; 
pgnum  ++  ; 

length[pgnum]  =  wordcnt ; 
pageclrO  ; 
dex  =  0  ; 


/* 

Increment  the  line  count  and  the  word  count  for  each  line  feed. 

*/ 

else 

if  (  ch  ==  LFEED  ) 

I 

lincnt++  ; 
page|dex]  =  ch  ; 
dex  ++  ; 
wordcnt  ++ ; 

} 

/* 

All  other  characters  become  part  of  the  page. 

*/ 

else 

I 

pagefdex]  =  ch  ; 
dex  ++  ; 
wordcnt  ++ ; 

} 
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Get  the  next  character. 


/* 

*/ 

ch  =  getc(fptrl) ; 


} 

/* 

Stores  the  last  page  if  the  last  page  is  not  tennintated 
with  a  form  feed. 

*/ 

if(wordcnt  !=  length(pgnuni] ) 

I 

fputs(page.fptr2) ; 
pgnuin  ++ ; 


/* 

Write  the  length  array  to  the  length  file. 

V 

lengthfpgnum]  =  wordcnt ; 
length  [Oj  =  pgnum  -  1  ; 
fwrite(length,sizeof(length),l  ,fptr3) ; 
fclosealK) ; 

) 
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FUNCTION  :  pageclr 

CALLED  BY:  txtmod 

CALLS  : NONE 

MODIFIED  :  4/12/90 

PERSON  :  Keith  Calcote 

PURPOSE  :  Puts  nulls  in  page  array 


*  *  *  *  *  *  *  *  *  *  If  *  *  *  if  If  *  *  *  *  *  *  *  *  *  *  *  *  **  *  *  *  *  *  *  *  *  *  *  *  *  sfi  *  *  *  *  %  *  *  *  *  *  *  *  *  %  *  *  *  *  *  *  if  *  *  *  *  *  J 


static  void  pagecli  0 

I 

int  loop  ; 

for(loop  =  0;  loop  <  PAGEL;  loop  ++) 
pagelloop]  =  VOO’ ; 

) 

TMOD.C  ***/ 
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APPENDIX  K 


THE  CODE:  FILE  "VENN.C" 


I********************************************************************** 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 


circle 

Turbo  C  Lib 

cleardevice 

Turbo  C  Lib 

closegraph 

Turbo  C  Lib 

detectgraph 

Turbo  C  Lib 

exit 

Turbo  C  Lib 

floodfill 

Turbt  C  Lib 

getch 

Turbo  C  Lib 

getmaxx 

Turbo  C  Lib 

getmaxy 

Turbo  C  Lib 

initigraph 

Turbo  C  Lib 

line 

1  urbo  C  Lib 

moveto 

Turbo  C  Lib 

outtext 

Turbo  C  Lib 

randomize 

Turbo  C  Lib 

rectangle 

Turbo  C  Lib 

setaspectratio 

Turbo  C  Lib 

setbkcolor 

Turbo  C  Lib 

setcolor 

Turbo  C  Lib 

setfillstyle 

Turbo  C  Lib 

settextjustify 

Turbo  C  Lib 

settextstyle 

Turbo  C  Lib 

PROGRAM  CALLS: 

NONE 
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VENN  FUNCTIONS: 

correct 

draw 

enter 

incorrect 

info 

reset 

title 

COMPLETED:  4/12/90 

PERSONS:  Keith  Calcote  &  Rick  Howard 

PURPOSE:  Provides  a  the  user  with  a  leraning  tool  that  drills  the 

relationship  between  logic  expressions  and  venn  diagrams 

**************************************************************'<********/ 
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/*  header  files  */ 


#include  <graphics.h> 

#include  <stdlib.li> 

#iiiclu<le  <math.h> 

#include  <time.h> 

/* . V 

/*  function  prototypes  */ 

static  void  correct! void); 
static  void  draw(void); 
static  void  enter! void); 
static  void  incorrect!void); 
static  void  info(void); 
static  void  resedvoid); 
static  void  title! void); 

- - */ 
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/*  globals  */ 

inf  driver; 

/*  Graphics  drive  number 

*/ 

int  mode  ; 

/*  Graphics  mode  number 

*/ 

hit  n  ; 

/*  Counter  */ 

int  left=0; 

/*  Left  most  pixel  coordinate 

V 

int  top=0 ; 

/*  Top  most  pixel  coordbiate 

V 

int  xmax,ymax; 

/*  Max  right  and  bottom  coordinate 

V 

int  radius; 

/*  Radius  of  the  circles  */ 

int  c_radius; 

/*  Corrected  radius  */ 

int  randnum  ; 

/*  Random  Number  1 

7 

int  header; 

/*  Holds  the  y-coordinate  for  the  header 

*1 

int  footer; 

1*  Holds  the  y-coordinate  for  the  footer 

V 

int  gap; 

/*  A  small  number  of  pixels 

V 

int  height ; 

/*  Verticle  distance  between  the  top  circle 

center  and  the  bottom  circle  center 

*/ 

int  xpositl,  ypositl  ; 

/*  x/y  coordinates  for  region  1 

*/ 

int  xposit2,  yposit2  ; 

1*  x/y  coordinates  for  region  2 

*/ 

int  xposit3,  yposit3  ; 

/*  x/y  coordinates  for  region  3 

*/ 

int  xposit4,  yposit4  ; 

/*  x/y  coordinates  for  region  4 

V 

int  xposit5,  yposit5  ; 

/*  x/y  coordinates  for  region  5 

V 

int  xposit6,  yposit6 ; 

/*  x/y  coordinates  for  region  6 

*/ 

bit  xposit7,  yposit7  ; 

/*  x/y  coord  mates  for  region  7 

*/ 
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int  xposit8,  ypositS  ; 

/*  x/y  coordinates  for  region  8 

*/ 

int  flag  1=0; 

/*  Set  if  region  1  is  filled 

*/ 

int  flag2=0; 

/*  Set  if  region  2  is  filled 

*/ 

int  flag3=0; 

/*  Set  if  region  3  is  filled 

*/ 

int  flag4=0  ; 

/*  Set  if  region  4  is  filled 

*/ 

int  flag5=(); 

/*  Set  if  region  5  is  filled 

V 

int  flag6=0; 

/*  Set  if  region  6  is  filled 

*/ 

int  flag7=0; 

/*  Set  if  region  7  is  filled 

*/ 

int  flag8=0  ; 

/*  Set  if  region  8  is  filled 

*/ 

int  sumflag=0 ; 

/*  Contains  total  number  of  regions  filles 

float  ratio ; 

/*  Used  to  determine  the  system  aspect  ration 

char  cli  =  ’x’; 

/*  User  response 

*/ 

/* . V 
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/*******+***************************+*****+*******+*****+************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 

Rick  Howard  &  Keith  Calcote 
See  Declarations 


% * * * * * * * * * * * * * * * ** * ** * * * * + * * * + * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * % * *  j 


main() 

I 

while(  1 ) 

{ 

/* 

Initialize  the  graphics  mode  for  die  user’s  screen. 

*/ 

detectgraph  (  &driver  ,  &mode) ; 
initgraph  (  &driver,  &mode  ,  "c^c") ; 
xmax  =  getniaxx() ; 
ymax  =  getmaxyO ; 


/* 

Set  the  background  color  to  BLUE. 

*/ 

setbkcolor(  1 ); 


/* 

Calculate  the  initial  screen  parameters. 

*/ 

radius  =  ymax  *  0.238  ; 
header  =  ymax  *  0.15  ; 
footer  =  ymax  *  0.95  ; 
gap  =  ymax  *  0.025  ; 
height  =  ymax  *  0.275  ; 
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/ * 

Determine  the  system’s  aspect  ratio. 

*/ 

ratio  =  (float )ymax/(float)xmax  *  10000  *  4  /3  ; 
setaspectratio((int)  ratio,  10000); 
ratio  =  10000/ratio  ; 
cjradius  =  radius  *  ratio  ; 

/* 

Draws  the  Venn  Diagram  circles  to  the  screen. 

*/ 

draw() ; 

/* 

Pick  a  random  Venn  Diagram  drawing  equation. 

*/ 

randomize!) ; 
n  =  9  ; 

randnum  =  random(n)  +  1  ; 

/* 

Display  the  question  on  the  screen. 

*/ 

title!) ; 

I* 

Display  instructions  to  the  screen. 

*/ 

info() ; 

/* 

Get  the  user’s  response. 

*/ 

ch  =  getch() ; 
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Based  on  the  user’s  input,  fill  each  chosen  region. 

V 

while(ch  !=  V’) 

{ 

switch(ch) 

{ 

case  ’1’ : 

floodfdl(xpositl,ypos it  1, WHITE) ; 
if(flagi  !=  1) 
sumflag++  ; 
flag!  =  1  ; 
break; 

case  ’2’  ; 

floodfill(xposit2,yposit2, WHITE) ; 
if(flag2  !=  1 ) 
sumflag++  ; 
flag2  =  1  ; 
break; 

case  ’3’  : 

floodfill(xposit3,yposit3,WHITE) ; 
if(flag3  !=  1) 
sumflag++  ; 
flag3  =  I  ; 
break; 

case  ’4’  : 

floodfdl(xposit4,yposit4, WHITE) ; 
if(flag4  !=  1) 
sumflag++  ; 
flag4  =  1  ; 
break; 

case  ’5’ ; 

floodfill(xposit5,yposit5, WHITE) ; 
if(flag5  !=  1) 
sumflag++  ; 
flag5  =  1  ; 
break; 
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case  ’6’  : 

£loodfill(xposit6,yposit6, WHITE) ; 
if(flag6  !=  1 ) 
sumflag++  ; 
flag6  =  I  ; 
break; 

case  ’7’ : 

floodfill(xposit7,yposit7, WHITE) ; 
if(flag7  !=  J) 
sumflag++  ; 
flag7  =  1  ; 
break; 

case  ’8'  : 

floodfill(xposit8,yposit8, WHITE) ; 
if(flag8  !=  1) 
sumflag++  ; 
flag8  =  1  ; 
break; 

case  V  : 
case  'E'  : 
draw() ; 
reset() ; 

title() ; 
info() ; 
break  ; 

case  ’q’  : 
case  ’Q"  : 
closegraph() ; 
exit(O) ; 
break; 
default ; 
break; 

}/*  end  switch  */ 
ch  =  getch() ; 

}/*  end  while  */ 
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/* 

Determines  if  the  user’s  answer  is  correct. 

*/ 

switch(randnum) 

I 

/* 

A’  intersect  B’  intersect  C’ 

*/ 

case  1  : 

if(sumflag  ==  1  &&  flag8  ==  1) 

I 

correct() ; 
reset  0  ; 

} 

else 

{ 

incorrect() ; 
getcli() ; 
draw( ) ; 
title!) ; 

floodfi  U!xposit8  ,yposit8  .WHITE) ; 
enter!) ; 
reset!) ; 

} 

break; 
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A  intersect  B  intersect  C 


/* 


case  2  : 

if(sumflag  ==  1  &&  flag7  ==  1 ) 

I 

correct() ; 
reset( ) ; 

) 

else 

I 

incorrect() ; 
getch() ; 
draw() ; 
title()  ; 

floodfill(xposit7,yposit7, WHITE) ; 
enter() ; 
reset() ; 

} 

break; 


/* 

A’  intersect  B  intersect  C 

*/ 

case  3  : 

if(sumflag  ==  1  &&  flag6  ==  1 ) 

I 

correct() ; 
reset( ) ; 

) 

else 

I 

incorrect() ; 
getch( ) ; 
draw() ; 
titleO  ; 

floodfill(xposit6,yposit6, WHITE) ; 
enter() ; 
reset() ; 

} 

break; 
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/* 

A  intersect  B  intersect  C’ 

*/ 

cose  4  : 

if(sumflag  =  1  &&  flag5  ==  1) 

I 

correct() ; 
reset( ) ; 

I 

else 

I 

incorrectO  ; 
getch() ; 
draw( ) ; 
titled  ; 

floodfill(xposit5,yposit5, WHITE) ; 
enter() ; 
reset() ; 

} 

break; 


/* 

A  intersect  B 1  intersect  C 

*/ 

case  5  : 

if(sumflag  ==  1  &&  flag4  ==  1 ) 

{ 

correct!) ; 
reset!) ; 

) 

else 

I 

incorrect!) ; 
getch() ; 
draw!) ; 
title!) ; 

floodfill(xposit4,yposit4, WHITE) ; 
enter! ) ; 
reset! ) ; 

) 

break; 
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/* 

C  intersect  (B  union  A)’ 

*/ 

case  6  : 

if(sumflag  ==  1  &&  flag3  ==  1 ) 

I 

correct() ; 
resetO  ; 

} 

else 

{ 

incorrectO  ; 
getch( ) ; 
draw( ) ; 
title(): 

floodfill(xposit3,yposit3, WHITE) ; 
enter( ) ; 
reset( ) ; 

} 

break; 


/* 

B  intersect  (C  union  A)’ 

*/ 

case  7  : 

if(suinflag  ==  1  &&  flag2  ==  1 ) 

{ 

correctt  ) ; 
reset() ; 

} 

else 

I 

incorrectO ; 
getch( ) ; 
draw( ) ; 
title() ; 

floodfiJl(xposit2,yposit2, WHITE) ; 
enter() ; 
reset( ) ; 

I 

break; 
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A  intersect  (B  union  C)’ 


/* 


case  8  : 

if(suntflag  ==  1  &&  flagl  ==  1 ) 

{ 

correct() ; 

reset() ; 

) 

else 

I 

incorrect() ; 

getch() ; 

<lraw( ) ; 
title() ; 

floodfill(xpositl,ypositl, WHITE) ; 
entet’O  ; 
reset() ; 

} 

break; 
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A  union  B  union  C 


case  9 : 

if(sumflag  ==  7  &&  flag8  ==  0) 

I 

correctQ  ; 
reset( ) ; 

} 

else 

I 

incorrectO ; 

getcho  ; 
draw( ) ; 
title() ; 

floodfill(xposit  1  ,yposit  1  ,WHITE) ; 
floodfill(xposil2,yposit2,WHITE) ; 
floodfill(xposit3.yposit3 .WHITE) ; 
floodfill(xposit4,yposit4, WHITE) ; 
floodfill  (xposit5  ,ypos  it5  .WHITE ) ; 
floodfdl(xposit6,yposit6, WHITE) ; 
floodfill (xposit7 ,yposit7 .WHITE) ; 
£nter( ) ; 
reset(); 

I 

bleak; 


} 

getch() ; 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


draw 

venn 

cleardevice 

settexi.style 

setcolor 

rectangle 

line 

moveto 

outtext 

circle 

setfillstyle 

4/12/90 

Keith  Calcote 

Draws  the  outline  and  circles  to  the  screen. 


static  void  draw(void) 

{ 

/* 

Initializes  graphics  text  font. 

*/ 

cleardevice( ) ; 

settextstyle(DEFAULT_FONT,HORIZ_DIR,l) ; 
setcolor( WHITE) ; 

/* 

Draws  the  basic  frame. 

*/ 

rectanglefleft,  top,  xmax,  ymax) ; 
Iine(0,header,xmax,header) ; 
line!0,footer, xmax, footer) ; 

/* 

Prints  "#1"  in  region  1. 

*/ 

xposit  I  =  xmax  /2  ; 
yposit  1  =  radius  +  header  +  gap  ; 
moveto! xposit  1 + 1 , yposit  1  -gap ) ; 
outtext!  "1") ; 
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/* 

Prints  "#2"  in  region  2. 

*/ 

xposit2  =  xpositl  +  radius  *  ratio  *  2/3 
yposit2  =  ypositl  +  height ; 
moveto(xposit2+l  ,yposit2) ; 
outtext("2") ; 

/* 

Prints  "#3"  in  region  3. 

*/ 

xposit3  =  xpositl  -  radius  *  ratio  *  2/3 
yposit3  =  yposit2  , 
moveto(xposit3+l,yposit3) ; 
outtext(”3") ; 

/* 

Prints  "#4"  in  region  4. 

V 

xposit4  =  xposit  1  -  radius  *  ratio  /3  ; 
yposit4  =  ypositl  +  radius  /sqrt(3) ; 
inoveto(xposit4+l,yposit4) ; 
outtext("4")  ; 

/* 

Prints  "#5"  in  region  5. 

*/ 

xposit?  =  xposit  1  +  radius  *  ratio  /3  ; 
yposit?  =  yposit4  ; 
inoveto(xposit5+l,yposit5) ; 
outtext("5") ; 

/* 

Prints  ”#6”  in  region  6. 

*/ 

xposit6  =  xpositl  ; 
yposit6  =  yposit2  ; 
moveto(xposit6+l,yposit6) ; 
outtext("6") ; 


/* 

Prints  "#7"  in  region  7. 

*/ 

xposit7  =  xpositl  ; 
yposit7  =  ypositl  +  radius  *  2/3  ; 
moveto(xposit7+l,yposit7) ; 
outtext("7") ; 

/* 

Prints  "#8"  in  region  8. 

*/ 

xposit8  =  2  *  gap  *  ratio  ; 
yposit8  =  header  +  2*  gap  ; 
moveto(xposit8+l,yposit8) ; 
outtext("8") ; 

/* 

Draws  the  three  circles. 

*/ 

circle(xpositl,ypositl,c_radius) ; 
circle(xposit2.yposit2,c_radius) ; 
circle(xposit3  ,yposit3  ,c_radius ) ; 

/* 

Draws  the  letters  A,  B,  &  C  in  the  three  circles. 

*/ 

settextstyle(DEFAULT_FONT,HORIZ_DIR,2) ; 
moveto(xpositl  ,  ypositl -radius/2) ; 
outtext("A") ; 

moveto(xposit2  +  radius/2  ,  yposit2+  2*gap) ; 
outtext("B") ; 

nioveto(xposit3  -  radius/2,  yposit3  +  2*gap) ; 
outtext("C") ; 

/* 

Resets  the  text  style  to  default. 

*/ 

settextstyle(DEFAULT_FONT,HORIZ_DIR,  1 ) ; 
setfillstyle(LTSLASH_FILL, WHITE) ; 


) 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


reset 

venn 

NONE 

4/12/90 

Keith  Cal  cote 

Resets  all  flags  to  zero. 


*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  %  *  *  *  *  *  *  *  *  *  *  *  %  *  *  *  *  *  *  *  **  *  i|t  *  %  4c  %  **  *  4c  4c  *  *  *  I 


static  void  reset(void) 

{ 

flagl =  0 ; 
flag2  =  0 ; 
flag3  =  0  ; 
flag4  =  0 ; 
flags  =  0 ; 
flag6  =  0  ; 
flag7  =  0  ; 
flag8  =  0 ; 
suinflag  =  0  ; 
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FUNCTION  : 
CALLED  BY. 
CALLS  : 


MODIFIED : 
PERSON  : 
PURPOSE  : 


title 

venn 

moveto 

settextjustify 

settextstyle 

outtext 

4/12/90 

Keitli  Calcote 

Prints  the  title  of  the  associated  Venn  Diagram. 


fc************************************************************#*********/ 


title() 

{ 

/* 

Moves  die  cursor  position  to  the  top  of  the  screen  and  sets 
the  text  justification  and  style. 

*/ 

inoveto(xmax  /2,  header  /2) ; 
settextjustify(CENTER_TEXT,CENTER_TEXT) ; 
settextstyle(DEFAULT_FONT,HORIZ_DIR,2) ; 

/* 

Displays  the  diagram  name  across  the  top  of  the  sceen. 

*/ 

switch(randnum) 

I 

case  1  : 

outtext("A’  intersect  B’  intersect  C’  ?") ; 
break; 

case  2 : 

outtext("A  intersect  B  intersect  C  ?") ; 
break; 

case  3  : 

outtext("A’  intersect  B  intersect  C  ?") ; 
break; 
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case  4 : 

outtext("A  intersect  B  intersect  C’  ?") ; 
break; 

case  5  : 

outtext("A  intersect  B’  intersect  C  ?") ; 
break; 

case  6  : 

outtext("C  intersect  (B  union  A)’  ?") ; 
break; 

case  7  : 

outiext("B  intersect  (C  union  A)'  ?") ; 
break; 

case  8  : 

outtext("A  intersect  (B  union  C)’  ?") ; 
break; 

case  9  : 

outtext("A  union  B  union  C  ?") ; 
break; 


} 

/* 

Resets  the  text  justification  and  style  to  default. 

*/ 

settext just ify ( LEFT_TEXT,TOP_TEXT ) ; 
settextstyle(DEFAULT_FONT,HORIZ_DIR,  1 ) ; 


) 
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^*********H<*************************l|<*******l)<  +  ****l|<!(<*s|<>t<>|t*’t'*’l<’l<l!<*J)<;(<>l's('>l<>l<l(<* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


info 

venn 

moveto 

outtext 

4/12/90 

Keitli  Calcote 

Displays  text  across  the  bottom  of  the  screen. 


^t*********** ********************************************************* i 


static  void  info(void) 

I 

moveto(gap,footer+gap/2) ; 
outtext("push  1-8  to  fill,  q  =  quit,  e  =  erase")  ; 
moveto(xmax  *3/5,footer+gap/2) ; 
outtext("enter  to  continue  "  ) ; 

) 


FUNCTION : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


correct 

vetm 

moveto 

outtext 

4/12/90 

Keith  Calcote 

Displays  "CORRECT"  at  the  bottom  right  hand  side  of  the 
screen. 


*****l(<**  +  >tl******  +  ********  +  *******!f**!fr*l|<**  +  ***  +  >)<  +  +  *!fl|<>f<*!|<>|tl|C***!|<>|«  +  +  l)fl|<!(<**l|y 


correct() 

I 

moveto(xmax  *4/5,footer-2*gap) ; 
outtext(  "CORRECT" ) ; 

) 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


incorrect 

venn 

moveto 

outtext 

4/12/90 

Keith  Calcote 

Displays  "INCORRECT"  at  the  bottom  right  hand  side  of  the 
screen. 


***  ****  *  *  ****  *  ***  *  *  *  *  *  *****  *  *  *  **  *  %*  *  **  ***  *  *  *  *  *  *  **  *  *  ******  *  **** + *  *  **  *  *  *j 


incorrect() 

( 

moveto(xmax  *4/5,footer-2*gap) ; 
outtext("lNCORRECT") ; 

I 


/ft********************************************************************* 


FUNCTION : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


enter 

venn 

moveto 

outtext 

4/12/90 

Keith  Calcote 

Displays  text  at  the  bottom  of  the  screen. 


♦  ♦♦♦Ik***************************** 


jk************************************/ 


enterO 

I 

moveto(gap,footer+gap/2) ; 

outtext("CORRECT  SOLUTION  IS  PRESENTED") ; 
moveto(xmax  *3/5, footer +gap/2) ; 
outtext(  "enter  to  continue  "  ) ; 


) 
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APPENDIX  L 


THE  CODE:  FILE  "PRINT.C" 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 


exit 

fclose 

fgets 

fopen 

fputs 

printf 


PROGRAM  CALLS: 


NONE 


PRINT  FUNCTIONS: 


COMPLETED: 


PERSONS: 


NONE 


4/12/90 


Rick  Howard 


PURPOSE:  Sends  a  file  to  the  printer 

*  ♦  ♦  ♦  *  *  aft  *  jff  jfe  *  aft  aft  *  aft  jfe  *  $  jfc  jft  jfc  afc  jt  %  $  +  it  Ifi  *  ♦  afe  *  *  *  afc  *  ♦  jfr  ♦  *  ★  *  *  ♦  ♦  ♦  ★  *  *  ★  *  ★  *  *  ♦  ♦  ♦  «k  +  ♦  *  *  ♦  *  ♦  *  *  ♦  ♦  ♦  ★  j 

/*  header  files  */ 

#include  <stdio.h> 

I* _ _ _ */ 
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/*  *  *  *  **  *  *  ******  *  **  *  ***  *  *  **  **  *  *  *  **  *  *  **  *  *  ****  *  i|c  %  *  ***  *  %  ****  *  *  *  *  *  **  *  **  **  )|(  *  * 


FUNCTION : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 
Rick  Howard 
See  Declarations 


********  ************  *  **  *  ********  *  *****  *  *  *  *  **  *  *  *  ****  *  ******  *  4c  *  *  *  *  *  *  *  *  *  *j 


main(argc,argv) 
int  argc; 
char  *argv|J; 


FILE  *fptrl; 
FILE  *fptr2; 
FILE  *fptr3; 
char  string[81J; 
/* 


/*  Pointer  to  die  file  to  be  printed  */ 

/*  Pointer  to  the  printer  device  */ 

/*  Pointer  to  a  NULL  file  */ 

/*  Array  that  holds  each  page  of  the  file  */ 


Error  checking. 

*/ 

if(argc  !=  2) 

1 

printf("Fomiat:  C>print  filename"); 
exit(); 

) 

if((  fptrl=fopen(argv[lJ,"r"))  ==  NULL) 

I 

printf("Can't  open  file  %s.",  argv[l]); 
exit(); 


if((  fptr2=fopen("pm" ,  "w"))  ==  NULL) 

( 

printf("Can’t  access  printer."); 
exit(); 

I 
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if((  fptr3=fopen("nothing.def",V'))  ==  NULL) 

( 

priiitf("Can't  open  nothing.def'); 
exit(); 


/* 

Send  one  page  at  a  time  to  the  printer. 

*/ 

while  (fgets(string,80,fptrl )  !=  NULL) 
fputs(string.fjptr2 ); 


/* 

Clear  the  buffer. 

*/ 

while  (fgets(string,80,fptr3)  !=  NULL) 
fputs(string.fp(r2); 


fclose(fptrI ); 
fclose(fptr2); 
fc!ose(fptr3); 
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APPENDIX  M 


THE  CODE:  FILE  "EXAM.C" 

/*********************************************************************** 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Navai  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 


error_exit 

DMT  Utilities 

exit 

Turbo  Lib 

fcloseall 

Turbo  Lib 

freatl 

Turbo  Lib 

fseek 

Turbo  Lib 

getch 

Turbo  Lib 

printf 

Turbo  Lib 

random 

Turbo  Lib 

randomize 

Turbo  Lib 

set_video 

DMT  Utilities 

strcat 

Turbo  Lib 

strcpy 

Turbo  Lib 

strtok 

Turbo  Lib 

waitkey 

CXL  Lib 

whelpcat 

CXL  Lib 

whelpdef 

CXL  Lib 

wopen 

CXL  Lib 

wprintf 

CXL  Lib 

wputsw 

CXL  Lib 

wtextattr 

CXL  Lib 

PROGRAM  CALLS: 

NONE 
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EXAM  FUNCTIONS: 

create_length_files 

error_check 

explanations 

errorjmsg 

get_answer 

get_question 

higlilight_correct_answer 

initialize 

open_window 

pageclr 

quit 

upr_lwr_case 
COMPLETED:  4/12/90 
PERSONS:  Rick  Howard  &  Keith  Calcote 
PURPOSE:  Present  the  user  with  an  exam  for  any  generic  lesson. 

t********************************************************************* 

i 

/*  header  files  */ 

#include  <stdio.h> 

#include  <stdlib.h> 

#include  <process.h> 

#include  <conio.h> 

#include  <time.h> 

#include  <string.h> 

#include  <math.h> 

#include  "d:\cxl\cxlwin.h" 

#include  "df'cxLcxlkey.h" 

#include  "d:\cxl\cxlvid.h" 

#include  "d:Mc\thesis\video.h" 

#include  "d:\tc\thesis\help.h" 

/* - */ 
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I*  funaion  prototypes  */ 
static  void  error_check(int  argc); 

static  void  error_msg(int  msg_num,  char  *string,  iiit  integer); 

static  void  create_length_files(char  *argv[]); 

static  void  open_window(void); 

static  void  initial ize(char  *argv[]); 

static  void  get_question(void); 

static  void  get_answer(void); 

static  void  upr_lwr_case(void); 

static  void  check_answer(void); 

static  void  highlight_correct_answer(void); 

static  void  explanations(void); 

static  void  results(void); 

static  void  pageclr(void); 

static  void  quit(void); 

/* - V 

/*  constatnts  */ 

#define  ROW  25 

#tlefine  COL  1 

#define  LEN  100 

#define  PAGEL  2000 

#define  CLR  wcclear(WHITEI_CYAN) 

#define  BOTTOM_LEFT  wgotoxy(15,0) 

/* . . -*/ 
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/*  globals  */ 


char  pagefPAGEL]  ; 
WINDOW  w,w  1 ; 
iiit  dummy _int; 
int  q!ength(LENl; 

int  elength|LEN]; 

int  pflag; 

int  loop; 

int  used_stack|LEN]  ; 

int  ch; 
int  recno; 

int  adjustment; 

int  num__quest; 

int  dex; 

int  n  ; 

bit  num_correct  =  0  ; 


/*  Holds  the  words  on  each  exam  page  */ 

/*  Window  handles  */ 

/*  Place  holder  for  the  errorjnsg  function  */ 

/*  Contains  the  number  of  bytes  per  page 
in  the  question  file  */ 

/*  Contains  the  number  of  bytes  per  page 
in  the  explanation  file  */ 

/*  Set  after  the  first  pass  thru  the 

question  file.  Allows  the  program  to 
strip  off  the  characters  */ 

/*  Counter  used  to  clear  the  page  buffer  */ 

/*  Array  that  holds  the  exam  questions 
already  presented  to  the  user  */ 

/*  Used  to  get  the  user's  response  */ 

/*  Desired  page  number  for  the  question 
and  explanation  file  */ 

/*  Used  to  accept  both  upper  and  lower 
case  input  from  the  user  */ 

/*  The  number  of  exam  questions 
desired  by  the  user  */ 

/*  Counter  used  to  annotate  the  number  .'f 
questions  presented  to  the  user  */ 

/*  Counter  */ 

/*  Used  to  keep  track  of  the  number  of 
correct  answers  given  by  the  user  */ 
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iiit  nurnjncorrect  =  0  ; 

long  int  q_offset,e_offset  ; 
float  grade  ; 

FILE  *fptrl  ; 

FILE  *fptr2  ; 

FILE  *fptr3  ; 

FILE  *fptr4  ; 
char  *dummy_string; 
char  *chptr; 

char  quest  Jenf  15], 
explJenll5J; 

char  quest_txt|  13], 
expl_txt[15J : 

char  answer[500j; 
char  your_ans; 
char  chi  ; 


/*  Used  to  keep  track  of  the  number  of 
incorrect  answers  given  by  the  user  */ 

/*  Used  to  point  to  a  desired  page  in  the  text  */ 

/*  Percentage  based  upon  the  user’s 
number  of  correct  answers  divided  by 
the  total  number  of  exam  questions  */ 

/*  Pointer  to  the  file  of  questions  */ 

/*  Pointer  to  the  question  length  file  */ 

/*  Pointer  to  the  file  of  explanations  */ 

/*  Pointer  to  the  explanation  length  file  */ 

/*  Place  holder  for  the  error_msg  function  */ 

/*  Holds  the  value  of  returned  by  the  function 
strtok()  */ 

/*  Holds  the  file  name  that  contains  the 
length  array  of  the  associated  file  */ 

/*  Holds  the  file  name  that  contains  the 
text  for  the  associated  file  */ 

/*  Holds  the  answers  to  the  questions  */ 

/*  Used  to  hold  the  user’s  response  */ 

/*  Used  to  hold  the  user’s  response  */ 
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*********************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 

Rick  Howard  &  Keith  Calcote 
See  Declarations 


main(int  argc,  char  *argvl]) 

I 

create_length_files(argv); 
error_check(argc ); 
open_window(); 
initial  ize(argv); 

for(dex  =  0:  dex  <  numjquest;  dex  ++) 

I 

get_question(); 

get_answer(); 

upr_lwr_case(); 

check_answer(); 

higlilight_coiTect_answer(); 

explanations(); 

} 

results(); 

fcloseaU(); 
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********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


error_check 

exam 

error_msg 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Determines  any  initialization  errors  and  displays  the 

the  appropriate  error  message. 


*****  ******  *******  *****1)1  ******  *1  *****  I*  *  ****  1*  *  4c  *  *  **  III  *  *  ******  *  *  I*  *  I*****  **  *J 


static  void  error_check(int  argc) 

I 

/* 

This  program  must  have  four  arguments. 

*/ 

if  (argc  !  =  4) 

error_msg(  1  .dummy  _string,dummy_int); 


/* 

Errors  in  opening  the  needed  files. 

*/ 

if  ((fptrl=fopen(quest_txt,"rb"))  ==  NULL) 
error_insg(2,quest_txt,dummy_int); 
if  ((fptr2=fopen(quest_len,"rb"))  ==  NULL) 
error_msg(2,quest_len,  dummy  _iiit); 
if  ((fptr3=fopen(expl_txt,"rb"))  ==  NULL) 
error_msg(2,expI_txt,dummy_int); 
if  ((fptr4=fopen(expl_len,"rb"))  ==  NULL) 
error_msg(  2  ,expl_len  ,dummy_int ) ; 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


create_Iength_files 

exam 

strtok 

strcpy 

strcat 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Creates  the  file  neames:  quest_len,  quest_txt,  expl_len  and 
expl_txt  from  the  command  line. 


*  **  *  *  *  *  **  *  *  *  ***  ♦  *  *  *  *  *  *  *  *  *  **  *  *  ***  *  ***  *  **** + *  ****  *  *  iff**  *  *  *  *  *  *  **  *  *  *  *  **  *  *  **  j 


static  void  create_length_files(char  *argv[]) 

I 

chptr  =  strtok(argv[2],".") ; 
strcpy(quest_txt,chptr) ; 
strcpy(quest_len, chptr) ; 
strcat(quest_len,".len") ; 
strcat(quest_txt,".txt") ; 

chptr  =  strtok(argv[3],".") ; 
strcpy(expl_txt, chptr) ; 
strcpy(expl_len, chptr) ; 
strcat(expl_len,".len") ; 
strcat(expl_txt,".txt") ; 

) 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


open_window 

exam 

set_video 

wopen 

error_exit 

whelpdef 

whelpcat 

4/12/90 

Rick  Howard 

Opens  a  window  on  the  screen  for  the  exam 


**************************************************/ 


static  void  open_window(void) 

I 

/* 

Check  for  mono,  CGA  or  EGA  screen. 

*/ 

set_video(); 


/* 

Open  a  window  to  display  the  exam. 

*/ 

if((  w=wopen(  2.0,23 .79,3  ,WHITEI_CY  AN,WHITEI_CY  AN))==0) 
wprintf(  "eri  or_exit(  1 


/* 

Define  the  help  screen  attributes. 

*/ 

whelpdeffDMT.HLP",  0x2368,  BLACKI_LGREY,BLACKI_LGREY, 

LBLUEI_LGREY,  LREDI_LGREY,  0); 


I* 

Set  the  current  help  screen. 

*/ 

whelpcat(H_TRUTH  TABLE_PROBLEM_SOLVER); 

} 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


initialize 

exam 

fread 

atoi 

randomize 

error_msg 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Sets  the  program  up  with  user  supplied  paramenters  and 
provides  initial  error  checking. 


************************************* *********************************/ 


static  void  mitialize(char  *argv[]) 

I 

fread(qlength.sizeof(qlength),l,fptr2) ; 
fread(elength.sizeof(elength),l,fpti4) ; 


/* 

Set  the  number  of  questions  desired  by  the  user. 

*/ 

num_quest  =  atoi(argv[l]) ; 
randoinizeO  ; 


/* 

The  explanation  file  must  have  the  same  number  of  explanations  as 
the  question  file  has  questions  or  there  exists  an  error. 

*/ 

if(qlength[0]  !=  elength[0J) 

error_msg(3,duinmy_string,  dummy_int); 


/* 

The  number  of  required  questions  must  be  less  than  the  number  of 
questions  available. 

*/ 

if(num_quest  >  qlength[0]) 

error_msg(4,  dummy  _string  ,qlength  [0] ) ; 
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/* 

The  total  number  of  questions  top  be  presented  is  placed  on  top 
of  a  stack. 

*/ 

for(dex  =  0;  dex  <  LEN;  dex  ++  ) 
used_stack|dex]  =  0  ; 

} 
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y************************ **************************** ****************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


get_question 

exam 

random 

fseek 

errorjmsg 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Retrieve  an  exam  question  from  the  exam  file 


********************************************************************* 


*/ 


static  void  get  question(void) 

{ 

/* 

Clear  the  window. 

*/ 

CLR  ; 

/* 

Choose  a  random  exam  question. 

*/ 

recno  =  random(qlength[0])  +  I  ; 

/* 

If  the  question  has  already  been  answered,  then  increment  the 
question  number  and  check  again. 

*/ 

for(n  =  0;  n  <  dex;  n  ++  ) 

{ 

if(  recno  ==  used_stack|n]) 

[ 

if(recno  =  qlength[0]) 
recno  =  1  ; 
else 

recno  ++  ; 
n  =  -l  ; 

} 

} 
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/* 

Places  the  selected  question  on  the  used  stack  and  sets  the  file 
pointer  to  the  desired  question  in  the  question  file. 

*/ 

used_stackldex]  =  recno  ; 
q_offset  =  qlengthjrecno] ; 
iff  fseek(fptrl,q_offset,0)  !=  0) 
error_msg(5 ,  dummy  .string  .dummy  _int); 

) 
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FUNCTION  : 
CALLED  BY. 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


get_answer 

exam 

pageclr 

fread 

printf 

strtok 

wprintf 

strcpy 

getch 

quit 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Displays  the  question  to  the  user  and  retrieves  the  corect 
answer. 


*  *  *  *  *  *  4c  *  *  *  *  *  *  *  *  *  *  *  *  *  **  *  *  *  *  *  *  *  *  *  *  *  *  *  if<  *  *  **  *  *  **  *  *  *  **  ****  *  ******  *  **  *  *  *  *  *  * 


static  void  get_answer(void) 

( 

/* 

Clear  the  page  buffer. 

*/ 

pageclr(); 

/* 

Sets  the  pointer,  chptr,  to  the  value  returned  by  strtok(). 

*/ 

fread(page,qlength[recno+lJ-qlength[recno],l  ,fptrl) ; 
printf("Vn") ; 
pflag  =  0 ; 

chptr  =  strtok(page,"(a>") ; 
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/* 

Strips  off  the  @  characters  and  displays  the  question. 

*/ 

while(chptr  !=  NULL) 


wprintf("9os", chptr) ; 
if(pflag  ==  0) 

I 

pflag  =  1  ; 

chptr  =  strtok(NULL,"<a>") ; 
strcpy( answer, chptr) ; 
strcpy(&answer[lJ,NULL)  ; 

} 

else 

{ 

chptr  =  strtok(NULL,"(a>") ; 


1 

/* 

Retrieve  the  user’s  choice. 

*/ 

your_ans  =  getch()  ; 

/* 

Tenninate  the  program  if  the  user  desires. 

*/ 

if  (your  ans  ==  ’Q’  II  your_ans  ==  ’q’) 
quif(); 


/* 

Clear  the  window. 

*/ 

CLR  ; 

) 


261 


^* ********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


upr_lwr_case 
exam 
NONE 
4/12/90 
Keith  Calcote 

Checks  for  user  input  in  either  upper  or  lower  case  and 
makes  the  proper  adjustment. 


**%***lk%**#*********’lt’l<’l<1t<*’l<*>tt*****’l<****>l<***!|<****4<!t<:i>>t'*lt'*:|<**>t<:|<%*>l<if<>l':<<#>l<*>l<!|y 


static  void  upr_lwr_case(void) 

I 

/* 

Sets  the  ad  justment  to  32  if  the  character  that  corresponds  to  the 
answer  is  in  lower  case. 

*/ 

if(  (mt)answer(OJ  >=  97  &&  (int)answer(O]  <=122  ) 
adjustment  =  32  ; 


/* 

Sets  the  adjustment  to  -32  if  the  character  that  corresponds  to  the 
answer  is  in  upper  case. 

*/ 

else  jf(  (int)answer[0]  >=  65  &&  (int)answer[Oj  <=  90  ) 
adjustment  =  -32  ; 


/* 

Sets  the  adjustment  to  0  if  the  character  that  corresponds  to  the 
answer  is  not  a  letter. 

*/ 

else 

adjustment  =  0 ; 


I 
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S<9)<a|r2fe9|c3|c3|e»fe9|c9fc9|c3|ca|(afr3fea4ea|<9|« 


FUNCTION  : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


check_answer 

exam 

wprintf 

pageclr 

4/12/90 

Keith  Calcote  &  Rick  Howard 

Checks  the  user’s  response  for  correctness. 


static  void  check_answer(void ) 

I 


if(your_ans  ==  answerfO]  II 

((int)your_ans  +  adjustment)  ==  (int)answer[0] ) 


{ 


wprintf("Your  answer  %c  was  CORRECT ,\n",your_ans) ; 
num_correct  ++  ; 

I 

else 

{ 

wprintf("Your  answer  %c  was  INCORRECT .\n",your_ans) ; 
num_incorrect  ++  ; 

} 


pagechO  ; 
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/* ******++*****+***************+*********+*****+************+*****+**** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


highlight_correct_answer 

exam 

fseek 

error_msg 

fread 

strtok 

wprintf 

wtextattr 

4/12/90 

Keith  Calcote  &  Rick  Howard 
Highlights  the  correct  answer  on  the  screen. 


*********************************+*********+*****+******+/ 


static  void  higlilight_correct_answer(void) 

( 

/* 

Reads  the  question  into  the  character  array  page. 

V 

if(  fseek(fptrl.q_offset,0)  !=  0) 

error_msg(5.  dummy  _string,dummy_int); 
fread(page.qlength[recno+lJ-qlength[recnoJ,l,fptrl) ; 

/* 

Sets  the  pointer  to  the  in  the  question. 

*/ 

pflag  =  0 ; 

chptr  =  strtok(page  ,"(©") ; 
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/* 

Points  to  the  higlilighted  question. 

*/ 

while(chptr  !=  NULL) 


wpiintf("%s",chptr) ; 
if(pflag  ==  0) 

I 

wtextattr(LCYANI_GREENIBLINK); 
pflag  =  1  ; 

} 

else 

wtextattr(WHITEI_CY  AN); 
chptr  =  strtok(NULL,"@") ; 
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/*  ************************ ***** ********** ****************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


explanations 

exam 

wprintf 

getch 

quit 

fseek 

error_msg 

pageclr 

fread 

wputsw 

4/12/90 

Keith  Calcote  &  Rick  Howard 

Provides  an  explanation  to  the  user  concerning  the  current 
exam  question  if  desired. 


*************************************************************%******** 


static  void  explanations! void) 

I 

/* 

Position  the  cursor  at  the  bottom  left  of  the  window. 

*/ 

BOTTOM  JLEFT ; 

wprintf("E  for  explanation,  enter  to  continue") ; 

/* 

Get  the  user's  response. 

*/ 

chi  =  getch() ; 

if  (chi  ==  ’Q’  II  chi  ==  q  ) 
quit(); 

CLR; 

if(chl  ==  ’E'  II  chi  ==  V) 

I 

/* 

Sets  the  offset  for  the  explanation  page. 

*/ 

e_offset  =  elength[recno] ; 
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/* 

Moves  the  file  pointer  to  the  desired  offset. 

*/ 

if(  fseek(fptr3,e_offset,0)  !=  0) 
error_msg(5,  dummy  _string,dummy_int); 


/* 

Clear  the  page  buffer. 

*/ 

pageclrO; 

/* 

Reads  the  explanationinto  the  character  array  page. 

*/ 

fread(page,elength[recno+l]-elength[recno],l  ,fptr3) ; 
/* 

Displays  the  explanation  on  the  screen. 

*/ 

wprintf("\n"); 

wputsw(page); 

BOTTOM_LEFT ; 
wprintf("Push  enter  to  continue")  ; 
getchf) ; 


} 
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FUNCTION  :  results 

CALLED  BY :  exam 

CALLS  :  wprintf 

getch 

MODIFIED :  4/12/90 

PERSON  :  Keith  Calcote  &  Rick  Howard 

PURPOSE  :  Shows  the  user  his  performance  on  the  exam. 


static  void  results(void) 

I 

CLR  ; 

wprintf("You  answered  %d  correctly\n",num_correct) ; 
wprintf("You  answered  %d  incorrectly\n\n",num_incorrect) ; 
grade  =  (float  )num_correct/(float)num_quest*100.0  ; 
wprintf("GRADE  %3.1f%", grade) ; 
getch() ; 

} 
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^* ******************************************************* ************** 


FUNCTION  : 
CALLED  BY: 


CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


pageclr 

get_answer 

check_answer 

explanations 

NONE 

4/12/90 

Keith  Calcote 

Clears  the  page  buffer 


static  void  pageclr(void) 

I 

int  loop  ; 

for(loop  =  0;  loop  <  PAGEL;  loop  ++) 
pagelloopj  =  ’\x00’  ; 

I 
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ji It  aft******************************************************************** 


FUNCTION :  error_msg 

CALLED  BY :  error_check 

initialize 
get_question 

highlight_correct_answer 

explanations 

CALLS  :  wprintf 

waitkey 

MODIFIED :  4/12/90 

PERSON  :  Rick  Howard 

PURPOSE  :  Displays  the  appropriate  error  message  for  a  known  problem. 

4 

static  void  error_msg(int  msg_num,  char  *string,  int  integer) 

I 

switch  (msgjnum) 

I 

case  1: 

wprintf("Format  is:  Q_&_A 
Nuinber_of_questions 
question_fiIe 
explanation_file"); 

break; 
case  2: 

wprintf( "Can’t  open  %s",  string); 
break; 
case  3: 

wprintf( "There  must  be  an  explanation  file  for  each  question"); 
break; 
case  4: 

wpt  intf("You  can  request  at  most  %d  questions",  integer); 
break; 
case  5: 

wprintf("Can  not  move  Pointer  there!"); 
break; 
default: 
break; 

} 
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/* 

Wait  for  the  user’s  response  and  quit. 

*/ 

waitkeyO; 

exit(O); 

} 
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FUNCTION : 
CALLED  BY: 

CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


quit 

get_answer 

explanations 

exit 

4/12/90 
Rick  Howard 
Terminates  the  program 


static  void  quit(void) 

( 

exit(0); 

) 
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APPENDIX  N 


THE  CODE:  FILE  "VENNINFO.C" 

^***^ ****************************************************************** 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 

LIBRARY  CALLS: 


circle 

Turbo  C  Lib 

cleardevice 

Turbo  C  Lib 

clrscr 

Turbo  C  Lib 

closegraph 

Turbo  C  Lib 

detectgraph 

Turbo  C  Lib 

exit 

Turbo  C  Lib 

floodfill 

Turbo  C  Lib 

getch 

Turbo  C  Lib 

getmaxx 

Turbo  C  Lib 

getmaxy 

Turbo  C  Lib 

gettext 

Turbo  C  Lib 

initigraph 

Turbo  C  Lib 

line 

Turbo  C  Lib 

inoveto 

Turbo  C  Lib 

outtext 

Turbo  C  Lib 

puts 

Turbo  C  Lib 

puttext 

Turbo  C  Lib 

randomize 

Turbo  C  Lib 

rectangle 

Turbo  C  Lib 

setaspectratio 

Turbo  C  Lib 

setbkcolor 

Turbo  C  Lib 

setcolor 

Turbo  C  Lib 

selfillstyle 

Turbo  C  Lib 

settextjustify 

Turbo  C  Lib 

settextstyle 

Turbo  C  Lib 

window 

Turbo  C  Lib 

PROGRAM  CALLS: 

NONE 
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VENNINFO  FUNCTIONS: 
draw 
title 

COMPLETED:  4/12/90 
PERSONS:  Keith  Calcote 

PURPOSE:  Provides  a  the  user  with  a  leraning  tool  that  drills  the 

relationship  between  logic  expressions  and  venn  diagrams 

ft*********************************************************************/ 
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/*  header  files  */ 


#include  <graphics.h> 

#include  <stdlib.li> 

#include  <niath.h> 

#include  <dos.h> 

#include  <conio.h> 

/* - */ 

/*  Constants  */ 

#define  NUMLIST  16 
#define  FONT  0 
#define  CHS1ZE  5 

/*- - - */ 
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/*  Globals  */ 

int  driver; 

/* 

int  mode  ; 

/* 

int  n  ; 

/* 

int  left=0,top=0 ; 

1* 

int  xmax,ymax; 

/* 

int  radius; 

/* 

int  cjradius; 

/* 

int  header.footer.gap.height ; 

/* 

/* 

int  xpositl.  yposill  ; 

int  xposit2,  yposit2  ; 

int  xposit3,  yposit3  ; 

int  xposit4,  yposit4  ; 

int  xpositl,  ypositS  ; 

int  xposit6,  yposit6  ; 

im  xposit7,  yposit7  ; 

int  xposit8,  yposit8  ; 

int  textbuff[4000] ; 

/* 

float  ratio  ; 

/* 

char  ch  ; 

/* 

/* 


Graphics  driver  number  */ 

Graphics  mode  number  */ 

Counter  */ 

Left  hand  and  top  most  positions  */ 

Holds  the  max  number  of  pixels  */ 

Max  desired  radius  of  circles  */ 

Radius  corrected  for  aspect  ratio  */ 

Screen  pixel  locations  */ 

x,y  coordinate  position  in 
pixels  that  correspond  to 
regions  in  the  Venn  Diagram  */ 


Menu  Storage  */ 

Compensation  for  non-square  pixels  */ 

Holds  user  selection  */ 
- */ 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 
Rick  Howard 
See  Declarations 


*********************************************************************/ 

niain() 

{ 

/* 

Possible  venn  diagrams  for  the  user  to  view 

*/ 

char  list[NUMLIST][80]  = 

I 

"  a.  A’  intersect  B’  intersect  C’", 

"  b.  A  intersect  B  intersect  C  ", 

"  c.  A’  intersect  B  intersect  C  ", 

"  d.  A  intersect  B  intersect  C’", 

"  e.  A  intersect  B’  intersect  C  ", 

"  f.  C  intersect  (A  union  B)’  ", 

"  g.  B  uitersect  (C  union  A)’  ", 

"  h.  A  intersect  (B  union  C)’  "  , 

"  i.  A  union  B  union  C  ", 

"  j.  A’  intersect  B’  ", 

"k.  B’  intersect  C’  ", 

"  1.  A  union  B’  ", 

"  m.  B  union  C’  ", 

"  n.  A  union  C’  ", 

"  o.  B  union  C  ", 

It  •  M 

q.  quit 


277 


/* 

Default  an  italic  type  of  graphics. 

*/ 

detectgraph  (  &driver  ,  &mode) ; 
initgraph  (  &  driver,  &mode  ,NULL) ; 
xmax  =  getmaxx() ; 
ymax  =  getmaxyO  ; 

/* 

Initial  screen  setup. 

*/ 

settextstyle(FONT+l,0,CHSIZE) ; 
moveto(xmax/2,ymax/2-75) ; 
settextjustify(l,l )  ; 
outtext(" Welcome  to  ")  ; 
inoveto(xmax/2,ymax/2+20) ; 
settextstyle(FONT+l  ,0,4) ; 
outtext("Venn  Diagram  Information") ; 
moveto(xmax/2,ymax-20) ; 
settextstyIe(FONT,0,l ) ; 
outtext("Q  =  quit,  Any  other  key  begins") ; 

/* 

Get  user  selection  from  the  initial  screen. 

*/ 

ch  =  getchO  ; 
closegraphO  : 
if  (ch  ==  ’q’  II  ch  ==  ’Q’) 

I 

clrscr() ; 
exit(0) ; 

) 

/* 

Print  to  screen  menu  list 

*/ 

window(0,0,80,25) ; 
clrscrO  ; 

for(n=0;  n<NL!MLJST;  n++) 
puts(&list(nj[0J) ; 
gettext(0,0,80.25,textbuff) ; 
ch  =  getch() ; 
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MICROCOPY  RESOLUTION  TEST  CHART 

NATIONAL  BUttLAU  OF'  STANDARDS  1 96 1  A 


/* 

Process  the  user  selection  from  the  menu  list. 

*/ 

do 


if  (ch  ==  ‘q'  II  ch  ==  'Q'  ) 

( 

clrscr() . 
exit(O) ; 


/* 

Initialize  the  graphics  system. 

*/ 

detectgraph  (  &driver  ,  &mode) ; 
initgraph  (  &driver,  &mode  ,NULL) ; 
xmax  =  getmaxx( ) ; 
ymax  =  getmaxyO ; 

/* 

Size  the  variables  based  on  the  number  of  pixels. 

*/ 

radius  =  ymax  *  0.238  ; 
header  =  ymax  *  0.15  ; 
footer  =  ymax  *  0.95  ; 
gap  =  ymax  *  0.025  ; 
height  =  ymax  *  0.275  ; 

/* 

Sets  the  aspect  ratio  so  tha  the  circles  look  like  circles  and 
not  elipses. 

*/ 

ratio  =  (float  )y max/( float  )xmax  *  10000  *  4  /3  ; 
setaspectratio((int)  ratio,  10000); 
ratio  =  10000/ratio  ; 
c_radius  =  radius  *  ratio  ; 

/* 

Draws  the  outline  of  the  venn  diagram. 

*/ 

draw() ; 
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/* 

Displays  the  title  that  corresponds  to  the  user  menu  selection. 

*/ 

titleO  ; 

/* 

Displays  the  message  in  the  lower  left  hand  comer. 

*/ 

moveto(gap.footer+gap) ; 
outtext("  Q  =  quit") ; 

/* 

Fills  the  regions  that  correspond  to  the  user  menu  selction. 

*/ 

switch(ch) 

I 

case  ’A’  :/*  A’  intersect  B’  intersect  C’  */ 
case  ’a’  : 

floodfill(xposit8,yposit8, WHITE) ; 
break; 

case  ’B  ’  :/*  A  intersect  3  intersect  C  */ 
case  TV  : 

floodfill(xposit7,yposit7,WHITE) ; 
break; 

case  ’C’  :/*  A’  intersect  B  intersect  C  */ 
case  ’c’  : 

floodfdl(xposit6,yposit6, WHITE) ; 
break; 

case  ’D’  :/*  A  intersect  B  intersect  C’*/ 
case  'd*  : 

floodfill(xposit5,yposit5, WHITE) ; 
break; 

case  ’E’  :/*  A  intersect  B’  intersect  C  */ 
case  ’e’  : 

floodfill(xposit4,yposit4, WHITE) ; 
break; 

case  ’F’  :/*  C  intersect  (A  union  B)’  */ 
case  T  : 

floodfill(xposit3,yposit3, WHITE) ; 
break; 
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case  ’G’  :/*  B  intersect  (C  union  A)’*/ 
case  ’g'  : 

floodfill(xposit2,yposit2,WHITE) ; 
break; 

case  ’H’  :/*  A  intersect  (B  union  C)’  */ 
case  'll'  : 

floodfill(xpositl,ypositl,WHITE) ; 
break; 

case  ’I  ’  :/*  A  union  B  union  C  */ 
case  ’i’  : 

floodfill(xposit  1  ,yposit  1 , WHITE) ; 
floodfill(xposit2,yposit2, WHITE) ; 
floodfill(xposit3,yposit3,WHITE) ; 
floodfill(xposit4,yposit4, WHITE) ; 
floodfill(xposit5,yposit5 , WHITE) ; 
floodfill(xposit6,yposit6, WHITE) ; 
floodfiH(xposit7,yposit7,WHITE) ; 
break; 

case  T  :/*  A’  intersect  B’  */ 
case  ’j’ : 

floodfill(xposit3,yposit3, WHITE) ; 
floodfii](xposit8,yposit8, WHITE) ; 
break; 

case  ’K’  :/*  B’  intersect  C’  */ 
case  ’k'  : 

floodfillixpositl ,ypositl,WHITE) ; 
floodfill(xposit8,yposit8, WHITE) ; 
break; 

case  ’L’  ;/*  A  union  B’  */ 
case  T  : 

floodfill(xpositl ,ypositl, WHITE) ; 
floodfiIl(xposit3,yposit3, WHITE) ; 
floodfill(xposit4,yposit4, WHITE) ; 
floodfil l(xposit5 ,yposit5 .WHITE ) ; 
floodfill(xposit7,yposit7, WHITE) ; 
floodfilI(.xposit8,yposit8, WHITE) ; 
break; 
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case  ’M’  :/*  B  union  C’  */ 
case ’m’  : 

floodfill(xposit  1  ,yposit J  .WHITE) ; 
floodfiJl(xposit2,yposit2, WHITE) ; 
floodfill(xposit5,yposit5, WHITE) ; 
floodfill(xposit6,yposit6, WHITE) ; 
floodfill(xposit7,yposit7  .WHITE) ; 
floodfill(xposit8,yposit8, WHITE) ; 
break; 

case  ’N’  :/*  A  union  C’  */ 
case  ’n’  : 

floodfiIl(xposit  1  .yposit  1  .WHITE) ; 
tloodfllI(xposit2,yposit2, WHITE) ; 
floodfill ( xposit4,yposit4 , WH ITE) ; 
floodfal(xposit5  .yposio  .WHITE ) ; 
floodf il  1( xposit 7  ,ypos it7  .WHITE ) ; 
floodfill(xposit8 ,yposit8 .WHITE ) ; 
break; 

case  ’O’  :/*  B  union  C  */ 
case  ’o’  : 

floodfilI(xposit2.yposit2.WHITE) ; 
floodfiIl(xposit3,yposit3, WHITE) ; 
floodfiII(xposit4,yposit4,WHITE) ; 
floodfill(xposit5,yposit5 .WHITE) ; 
fl  ood  f i  I K  xpos  i t6  ,ypos  it6 , W  H  ITE ) ; 
floodfiIl(  xposit 7  ,ypos  it7 , W HITE)  ; 
break; 

}/*END  SWITCH*/ 

/* 

Process  sthe  user  selection  to  quit  or  continue. 

*/ 

ch  =  getcb( ) ; 
closegraph( ) ; 
if  (ch  ==  ’q'  II  ch  ==  ’Q’) 

I 

clrscrQ  ; 
continue  : 

} 
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Print  to  screen  menu  list 


/* 

*/ 

puttext(0,0.80,25,textbuff) ; 
ch  =  getcho  ; 

}/*  END  do  while  */ 
while(ch  !=  ’q'  &&  ch  !=  ’Q') 
clrscr( ) ; 


)/*  END  MAIN  */ 


^*  ********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


draw 

venninfo 

cleardevice 

settextstyle 

setcolor 

rectangle 

line 

moveto 

outtext 

setfillstyle 

4/12/90 

Keith  Calcote 

Draws  the  venn  diagram 


****************************************************************** ****^ 


draw() 

I 

/* 

Initializes  the  screen  and  sets  the  style  and  color  defaults. 

*/ 

cleardevice() ; 

settextstyle(DEFAULT_FONT,HORIZJDIR,l) ; 
setcolor( WHITE) ; 

/* 

Draws  the  oudine  for  the  diagram. 

*/ 

rectangle(ieft,  top,  xmax,  ymax) ; 
line(0, header, xniax,header) ; 
line(0,footer,xmax, footer) ; 

/* 

Identifies  the  eight  regions  on  the  venn  diagram  by  their 
x,y  coordinates. 

*/ 

xposit  1  =  xmax  /2  ; 

yposit  1  =  radius  +  header  +  gap  ; 

xposit2  =  xposit  1  +  radius  *  ratio  *  2/3  ; 
yposit2  =  yposit  1  +  height ; 
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xposit3  =  xpositl  -  radius  *  ratio  *  2/3  ; 
yposit3  =  yposit2 ; 

xposit4  =  xposit  l  -  radius  *  ratio  /3  ; 
yposit4  =  ypositl  +  radius  /sqrt(3) ; 

xposit5  =  xpositl  +  radius  *  ratio  /3  ; 
yposit5  =  yposit4  ; 

xposith  =  xpositl  ; 
yposit6  =  yposit2  ; 

xposit7  =  xpositl  ; 

yposit7  =  ypositl  +  radius  *  2/3  ; 

xposit8  =  2  *  gap  *  ratio  ; 
yposit8  =  header  +  2  *  gap  ; 

/* 

Draws  the  three  circles  for  the  venn  diagram. 

*/ 

circle(xpositl  ,yposit  1  ,c_radius) ; 
circle(xposit2.yposit2,c_radius) ; 
circle(xposit3 .y posit3 ,c_radius ) ; 

/* 

Identifies  the  three  regions  on  the  venn  diagram  as  A,  B  and  C. 

*/ 

settextstyle(DEFAULT_FONT,HORIZ_DIR,2) ; 
moveto(xpositl  ,  ypositl -radius/2) ; 
outtext("A") ; 

moveto(xposit2  +  radius/2  ,  yposit2+  2*gap) ; 
outtext("B") ; 

moveto(xposit3  -  radius/2,  yposit3  +  2*gap) ; 
outtext("C") ; 

/* 

Sets  the  text  style  back  to  default. 

*/ 

settextstyle(DEFAULT_FONT,HORJZ_DIR,l) ; 
setfillstyle(LTSLASII_FILL, WHITE) ; 

} 
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y********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


title 

vermin  fo 

moveto 

settextjustify 

settextstyle 

outtext 

4/12/90 

Keith  Calcote 

Displays  the  title  of  the  selected  venn  diagram. 


**********************************************************************/ 


title() 

{ 

/* 

Moves  the  cursor  position  to  the  title  area. 

*/ 

moveto(xmax  /2,  header  /2) ; 
settextjustify(CENTER  TEXT,CENTER_TEXT) ; 
settextstyle(DEFAULT_FONT,HORIZ_DIR,2) ; 

/* 

The  title  is  displyed  based  upon  the  user’s  menu  selection. 

*/ 

switch(ch) 

I 

case  ’A’ : 
case  ’a’  : 

outtext("A'  intersect  B’  intersect  C’") ; 
break; 

case  ’B’  : 
case  ’b’  ; 

outtext("A  intersect  B  intersect  C") ; 
break; 

case  ’C’ : 
case  ’c’ : 

outtext("A'  intersect  B  intersect  C") ; 
break; 
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case  'D'  : 
case  ’d'  : 

outtext("A  intersect  B  intersect  C’") ; 
break; 

case  ’E’ : 
case  V  ; 

outtext("A  intersect  B'  intersect  C") ; 
break; 

case  ’F’  : 
case  T  : 

outtext("C  intersect  (B  union  A)’")  ; 
break; 

case  ’G’  : 
case  ’g’  : 

outtext("B  intersect  (C  union  A)’") ; 
break; 

case  ’H’  : 
case  ’ll'  : 

outtext("A  intersect  (B  union  C)”’)  ; 
break; 

case  T  : 
case  ’i'  : 

outtext("A  union  B  union  C") ; 
uieak, 

case  ’J’  : 
case  ’j’  : 

outtext("A’  intersect  B’") ; 
break; 


case  ’K’  : 
case  ’k’  : 

outtext(”B‘  intersect  C’") ; 
break; 
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case  ’L’  : 
case  *1'  : 

ojttext("A  union  B"") ; 
break: 

case  ’M'  : 
case  ’in’  : 

outtext("B  union  C’"); 
break; 

case  ’N'  : 
case  ’n’  : 

outtext("A  union  C’"); 
break; 


case  ’O'  : 
case  ’o’  : 

outtext("B  union  C")  ; 
break; 


case  ’Q'  : 
case  ’q’  : 
clrscrO  ; 
exit(O) ; 
break  ; 

default : 
break  ; 

)/*  END  switch  */ 

settext  justify(LEFT_TEXT,TOP_TEXT) ,  /*  default  settings  */ 
settextstyle(DEFAULT_FONT,HORIZ_DlR,l ) ; 

}/*  END  titlef)  */ 
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APPENDIX  O 


THE  CODE:  FILE  "RULES.C" 

’*********************************************************************** 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 

FILENAME:  rules. c 

LIBRARY  CALLS: 


exit 

Turbo  C  Lib 

waitkey 

CXL  Lib 

wccleai 

CXL  Lib 

whelpcat 

CXL  Lib 

whelpdef 

CXL  Lib 

w'open 

CXL  Lib 

wprintf 

CXL  Lib 

wshadow 

CXL  Lib 

wtitle 

CXL  Lib 

set  video 

DMT  Utilities 

PROGRAM  CALLS: 

NONE 

RULES  FUNCTIONS: 
and 
iff 

imply 

or 

prejielp 

quit 

COMPLETED:  4/12/90 

PERSONS:  Keith  Calcote  &  Rick  Howard 

PURPOSE:  Displays  a  quick  reference  truth  table  for  the  following 

logic  expressions:  AND.  OR,  IMPLIES  and  1F-&-ONLY-IF 


/*  header  files  *' 

#include  <stdio  h> 

#inelude  "d^xbcxlwin.h" 

#include  "d:\cxlYxlkey.h" 

#include  "d:\cxl\cxlvid.h" 

#include  "d:\lc\lhesis\video.h" 

#include  "d:\tc\lhesis\help.h" 

/* _ _ _ _ _ _ */ 

r  function  prototypes  */ 

static  void  and(void); 
static  void  or(void); 
static  void  imply  (void); 
static  void  iff( void); 
static  void  quit(void); 
static  void  pre_help(void); 

/* . - . - - - - - . */ 

/*  Macros  */ 

#<lcfine  HEADING  wpruitf("  P  \xb3  Q  \xb3\xb3  ") 

#define  FF  wprintfC  F  \xb3  F  \xb3^b3  ") 

#define  FT  wprintf("  F  \xb3  T  \xb3\xb3  ") 

#define  TF  wprintf("  T  \xb3  F  \xb3\xb3  ") 

#define  TT  wprintf("  T  \xb3  T  \xb3\xb3  ") 

#define  LINE  wprintf(”\x20\x20\x20\xc4\xc4Nxc4\xc4\xc4\xc4\xc5\xc4") 
#define  L1NEP  Wprintf(,'\xc4\xc4\xc4\xc4\xc4\xc4\xc4\xc5\xc5\xc4\xc4\xc4") 
#define  LINEPP  Wprintf(”\xc4\xc4\xc4\xc4\xc4\xc4\xc4\xc4\xc4\n") 

#define  TRUE  wprintf("  TVi") 

#define  FALSE  wprintf("  F\n") 

#define  CLR  wcclear(WHITELCYAN); 

#define  SPACE  wprintf("\n"); 

/* . — . - . */ 
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a********************************************************* 


FUNCTION  : 
CALLED  BY. 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 

Rick  Howard  &  Keith  Calcote 
See  Declarations 


********  **************  I)!***********************************************/ 


mainO 

{ 

/* 

Check  for  mono,  CGA  or  EGA  screen. 

7 

set_video(); 


/* 


Define  all  hot-keys. 

7 

setonkey(0x3B00,and,0); 

/* 

FI 

7 

setonkey(0x3C00,or,0); 

1* 

F2 

7 

setonkey  (Ox  3  D00 ,  i  mpl  y  ,0 ); 

r 

F3 

7 

setonkey(0x3E00.iff,0); 

z* 

F4 

7 

setonkey  (0x01  lB,quit,0); 

i* 

ESC  7 

/* 

Open  a  window  for  the  truth  table. 

7 

if(!wopen(2,42,l  1 ,77,3,WHITEI_CYAN,WHITEI_CYAN))  quit(); 

wtitle("l  FI  -AND  F2-OR  F3-1MPLY  F4-IFF  ]",TCENTER,BLUEI_CYAN); 

wshadow(LGREYI_BLACK); 

/* 

Define  the  help  screen  attributes. 

7 

whelpdef("DMT.HLP", 0x2368, BLACKIJLGREYJBLACKLLGREY.LBLUEIJLGREY, 
LREDI_LGREY,pre_help); 
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r 

Set  the  help  screen  that  applies  to  any  generic  lesson. 

*/ 

whelpcat(H_TRUTH_TABLE_RULES); 

/* 

Wait  for  the  user’s  response. 

*/ 

while  (waitkeyO  !=  0x4C35); 
wprintf("Error  =  %s\n",wernnsg()); 
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/a******************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


and 

rules 

wprintf 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Displays  the  truth  table  for  the  logic  expression  "AND" 


**********************  *  *  *  *  *  *  *  **  *  *  *  *  **  *  *  *  *  ***********  *  **  *  *  *  *  ^  *  *  **  *  *  *  *  + 


static  void  aiul(void) 

( 

CLR; 

SPACE; 

HEADING  ; 
wprintl'("P  ANDQW) ; 
LINE; 

LINEP; 

LINEPP; 

TT ; 

TRUE; 

TF; 

FALSE; 

FT; 

FALSE; 

FF; 

FALSE; 

) 
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^********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


or 

rules 

wprintf 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Displays  the  truth  table  for  die  logic  expression  "OR" 


************************ 


************** ******* *************************^ 


static  void  or(void) 

{ 

CLR; 

SPACE; 

HEADING  ; 
wprintf("P  OR  QVi") ; 
LINE; 

L1NEP; 

LINEPP; 

TT ; 

TRUE; 

TF; 

TRUE; 

FT; 

TRUE; 

FF; 

FALSE; 

} 
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/*  *  *****************  *  *  *  **  *  *******  *  *  *  ******  *  *  ******  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  +  + 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


imply 

rules 

wprintf 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Displays  the  truth  table  for  the  logic  expression  "IMPLY" 


*************************************************1|t,(<,(<J|(*1)<J(<:|<i(<])<i)<)|(j|ti(t](t))(j(ci|(](t](tj)^ 


static  void  iniply(void) 

I 

CLR; 

SPACE; 

HEADING  ; 

wprintf("P  IMPLIES  Q\n") ; 
LINE; 

LINEP; 

LINEPP; 

IT; 

TRUE; 

TF; 

FALSE; 

FT; 

TRUE; 

FF; 

TRUE; 

I 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


iff 

rules 

wprintf 

4/12/90 

Rick  Howard  &  Keith  Calcote 

Displays  the  truth  table  for  the  logic  expression  "IFF" 


**************  ******************* 


static  void  iff(void) 

I 

CLR; 

SPACE; 

HEADING  ; 
wprintffP  IFF  QV) ; 
LINE; 

LINEP; 

LBMEPP; 

TT ; 

TRUE; 

TF; 

FALSE; 

FT; 

FALSE; 

FF; 

TRUE; 

I 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


quit 

rules 

wprintf 

4/12/90 

Rick  Howard  &  Keith  Calcote 
Terminate  the  program 


**********************************************************************/ 


static  void  quit(void) 

I 

exit(0); 


/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


prejielp 

rules 

wshadow 

setonkey 

4/12/90 

Rick  Howard  &  Keith  Calcote 

draws  a  shadow  behind  the  open  window' 


*********************** 


***********************************************/ 


static  void  pre_help(void) 

( 

wshadow(LGREYI_BLACK); 

I 
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APPENDIX  P 


THE  CODE:  FILE  "TABLE.C" 


The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 


atoi 

Turbo  C  Lib 

exit 

Turbo  C  Lib 

ltoa 

Turbo  C  Lib 

setonkey 

CXL  Lib 

set_video 

DMT  Utilities 

strcat 

Turbo  C  Lib 

strcmp 

Turbo  C  Lib 

strcpy 

Turbo  C  Lib 

strlen 

Turbo  C  Lib 

strupr 

Turbo  C  Lib 

waitkey 

CXL  Lib 

wcclear 

CXL  Lib 

wcenters 

CXL  Lib 

wgets 

CXL  Lib 

wgotoxy 

CXL  Lib 

whelpcat 

CXL  Lib 

whelpdef 

CXL  Lib 

wopen 

CXL  Lib 

wprintf 

CXL  Lib 

wshadow 

CXL  Lib 

PROGRAM  CALLS: 

NONE 
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TABLE  FUNCTIONS: 
and 

display  _loop 

enor_response 

findlhcol 

findrhcol 

iff 

imply 

negation 

or 

pause 

pre_help 

quit 

replstr 

update_name 


COMPLETED: 


4/12/90 


PERSONS: 


Keith  Calcote  &  Rick  Howard 


FURFOSE: 


Displays  the  truth  table  to  any  user  supplied  logic 
equation 


/*  header  files  *1 

#include  <stdio.h> 

#include  <process.h> 

#include  <stdlib.h> 

#include  <string.h> 

#include  "d:\cxl\cxlwin.h" 

#include  "d:\cxl\cxlkey. h" 

#include  "d:VxLcxlvid.h" 

#include  "d:\tc\thesis\video.h" 

#include  "d:\tc\lhesisMielp.h" 

/*- - - */ 
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/*  Consents  */ 


#define  LEN  81 

#define  NUMLABEL  81 

#define  NUMELE  20 

#defiiie  NUMCOL  40 

#defiiie  CLR  wcc!ear(WHITEI_CYAN); 

#define  1NPUT_ERR0R  1 
#define  PAREN_MISMATCH  2 
#define  INVALID_CHAR  3 

/* - */ 


f*  Type  Definitions  */ 

struct  table 

{ 

char  element|NUMELE] ; 
chat  label|NUMLABEL] ; 
char  name  [LEN  J ; 


struct  table  col  [NUMCOL]  ; 

/*- . */ 

/*  globals  */ 

char  nextcol[NUMLABEL],lastcollNUMLABEL] ; 

char  numstmg[LENJ ; 

int  length, numcols,lhcol,rhcol ; 

long  lvalue  ; 

/* - - */ 
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/*  function  prototypes  */ 

static  char  and(char[LEN]) ; 

static  char  or(char[LENj) ; 

static  char  imply(char[LENJ) ; 

static  char  iff(char|LEN]) ; 

static  void  error_response(int  num); 

static  void  pause(void); 

static  void  quit(void); 

static  void  display _loop(void); 

static  void  pre_help(void); 

static  void  updatename(char  str[],  char  origstr[]); 

static  void  negations(char  strll); 

static  void  findlhdcolfchar  str|],  int  addr); 

static  void  findrhcolfchar  str[],  int  addr); 

static  void  replstr(char  str[J,  cliar  loc[J,  chr  rep[]); 

/* . . . */ 
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^i********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 

Rick  Howard  &  Keith  Calcote 
See  Declarations 


**********************************************************************/ 

mainO 

I 

WINDOW  w;  /*  Window  handle  */ 

/* 

Define  the  hot-key  for  this  program. 

*/ 

setonkey(0x01  lB.quit,0); 


/* 

Check  for  mono,  CGA  or  EGA  screen. 

*/ 

set_video(); 


/* 

Open  a  window  to  display  the  program. 

V 

if((w=wopen(2. 0,23 ,79,3 ,  WHITEI_CY  AN,  WHITEI_CYAN )  )==0 ) 
wprintl'("error_exit(  1 


/* 

Define  the  help  screen  attributes. 

*/ 

whelpdefC’DMT.  HLP"  ,0x2368  ,BLACKI_LGREY  ,B  LACK  l_LGREY , 

LB  LUEI_LGRE  Y  ,LREDI_LGR  EY  ,pre_help ) ; 


/* 

Set  the  truth  table  help  screen  in  place. 

*/ 

whelpcat(H_TRUTH_TABLE_PROBLEM_SOLVER); 
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/* 

Present  the  title  screen  to  the  program. 

*/ 

CLR; 

wcenters(l,YELLOWI_BROWN." Welcome  to  the  truth  table  generator"  ) 
/* 

Begin  the  main  program. 

*/ 

while(  I ) 

display  _loop(); 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


display  _loop 

table 

strcpy 

wcenters 

wgotoxy 

wgets 

strupr 

strcpy 

ltoa 

strcmp 

replstr 

negation 

and 

or 

imply 

iff 

strcat 

wprintf 

4/12/90 

Rick  Howard  &  Keith  Calcote 

The  main  loop  of  the  table,  allows  the  user  to  cycle  through 
as  many  truth  tables  as  he  desires 


********************************************************************** 


static  void  display_loop(void) 

I 

char  key  ; 

char  input  [LENJ; 

char  templ|LEN); 
char  temp2|LEN|; 
char  temp3[LENJ; 

char  nulline[LEN]  ; 

char  replacenum[IOJ  ; 

ini  dex.n  ; 


/*  Holds  the  user’s  input 
/*  User’s  desired  equation 
/*  Temorary  string  storage 

/*  NULL  String 
/*  Temporary  string  storage 
/*  Counters 


*/ 

*/ 

V 


*/ 

*/ 

V 
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iiit  openpar  =  0  ;  /*  Total  number  of  open  parens  */ 

bit  closepar  =  0  ;  /*  Total  number  of  closed  parens  */ 

bit  pflag  =  0  ;  /*  Set  if  "p"  is  used  as  a  proposition  */ 

bit  qflag  =  0  ;  /*  Set  if  "q"  is  used  as  a  proposition  */ 

int  rflag  =  0  ;  /*  Set  if  "r"  is  used  as  a  proposition  */ 

bit  sflag  =  0  ;  /*  Set  if  "s"  is  used  as  a  proposition  */ 

bit  frstclspar  :  /*  The  location  of  the  first  closed  paren  */ 

int  frstopenpar ;  /*  The  location  of  the  first  open  paren  */ 

bit  sumflag  ;  /*  Total  number  of  different  propositions  used  */ 

bit  breakflag  ;  /*  Flag  used  to  break  out  of  a  while  loop  */ 


/* 

Wait  for  the  user  to  press  any  key. 

*/ 

paused; 

CLR; 

/* 

Nullifies  the  struct  table  coll], 

*/ 

for(dex  =  0;  dex  <  NUMCOL;  dex  ++) 

I 

for(n  =  0;  n  <  NUMELE;  n  ++) 
col(dex|.element|nJ  =  \i(XT  ; 
for(n  =  0;  n  <  NUMLABEL;  n  ++) 
col[dex].label[n]  =  VOO' ; 
for(n  =  0;  n  <  LEN;  n  ++) 
col(dex|.namelnJ  =  VOO’  ; 

) 
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/* 

Sets  the  null  string  to  NULL. 

*/ 

for(dex  =  0;  clex  <  LEN;  dex++) 
nulline[dexj  =  "SxOO’  ; 


/* 

Initialiizes  all  strings  to  NULL. 

*/ 

strcpy ( inpu t  .null  ine ) ; 
strcpy(teinpLnulline) ; 
strcpy(temp2.nulline) ; 

Strcpy(temp3 .null ine) ; 
strcpy(replacenum,nulline) ; 

/* 

Get  the  user’s  logic  equation  and  converts  to  upper  case. 

*/ 

wcenters(0,WHITEI_CYAN,"Enter  the  equation  for  the  truth  table:"); 

wgotoxy(2,0); 

wgets(input) ; 

strupi  (input ) ; 

/* 

Removes  blanks  frorm  the  input  equation. 

*/ 

for  (dex  =  0;  dex  <  strlen(input);  dex++) 

I 

jf(input[dex]  ==  ’  ’) 

I 

strcpy(&input|dex],  &input(dex+lj) ; 
dex  —  ; 

} 

) 
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/* 

Examines  each  element  of  the  input  string  for  possible  errors. 

*/ 

for  (dex=0;  dex  <  strlen(input);  dex++) 

( 

switch(input[dex]) 

( 

case  ’(’  : 

switch(  input  [dex+ 1  ] ) 

I 

case  : 
case  : 
case  T  : 
case  ’>’  : 
case  ’=’  ; 

error_response(INPUT_ERROR); 
default : 
break  ; 

) 

openpar++  ; 
break  ; 

case  ’)’  : 

switch(input[dex+ 1  ]) 

( 

case  : 
case  ’R’  : 
case  ’P’  : 
case  ’Q’  : 
case  ’S’  : 

eri  or_i  esponse(INPUT_ERROR ); 
default : 
break  ; 

I 

closepar++  ; 
break  ; 
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case  ’-’  : 

sw  itch(Lnput  [dex+ 1  ] ) 

( 

case  ’)'  : 
case  ’&'  : 
case  T  : 
case  ’>’  : 
case  ’=’  : 

er  ror_response(IN  PUTJERROR ) ; 
default : 
break  ; 

> 

break  ; 
case  ’P’  : 

switch(input|dex+ 1 J ) 

{ 

case  ’(’  • 
case  ’-’  : 
case  ’R’ : 
case  ’P’  : 
case  ’Q’  : 
case  ’S’  : 

error_response(lNPUTJERROR ); 
default  : 
break  ; 

I 

pflag  =  1  : 
break  ; 
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case  ’Q’  : 

switch(input  [dex+ 1 J ) 

I 

case  ’(’  : 
case  ’-’ : 
case  'R'  : 
case  ’P’  : 
case  ’Q' : 
case  ’S’ : 

error_response(INPUT_ERROR); 
default : 

break  : 

I 

qflag  =  1  ; 
break  ; 

case  ’R’ : 

switch(input[dex+ 1 J ) 

{ 

case  ’(’  : 
case  : 
case  ’R'  : 
case  ’P’  : 
case  ’Q'  : 
case  ’S’  : 

error_response(INPUT_ERROR ); 
default  : 
break  ; 

I 

rflag  =  1  ; 
break  ; 
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case  ’S’  : 

s  w  itch(  input  [dex+ 1  ] ) 

{ 

case  ’(’  : 
case  : 
case  ’R’  : 
case  ’P’  : 
case  ’Q’  : 
case  ’S’  : 

error_response(INP  UT_ERROR ); 
default  : 
break  ; 


sflag  =  1  ; 
break  ; 

case  ’&’  : 
case  T  : 
case  ’>'  : 
case  ’=’  : 

s  w  itch(input  [dex+1]) 

I 

case  ’)’  : 
case  ’&’  : 
case  T  : 
case  ’>’  : 
case  ’=’  : 
case  VOO’  : 

error_response(INPUT_ERROR); 
default : 
break  ; 

} 

break  ; 
case  ’  ’ : 
break  ; 

default: 

error_response(INV  ALID_CHAR ); 

) 

I 
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/* 

Check  for  paren  errors. 

*/ 

if(openpar  !=  closepar) 

( 

error_respotise(PAREN_M!SMATCH); 

} 

/* 

Determines  how  many  of  the  possible  variables  are  used. 

*/ 

sumflag  =  pflag  +  qflag  +  rflag  +  sflag  ; 
if(sumflag  ==  0  ) 

I 

quit(); 

I 

numcols  =  sumflag  ; 

/* 

Create  initial  columns. 

*/ 

switch(sumflag) 

I 

case  (4) : 
length  =  16  ; 
strcpy(col|OJ. label,' "P") ; 

Strcpy(col|  1 1. label, "Q") ; 
strcpy(col|  2). label, ”R” ) ; 
strcpy(col[3]. label, "S") ; 

strcpy(col[()].element,"TTTTTTTTFFFFFFFF") ; 
strcpy(colll  ].element,"TTTTFFFFTTrTFFFF") ; 
strcpy(col|2].element,"TTFFTTFFTTFFTTFF") ; 
strcpy(coll3J.element,"TFTFTFTFTFTFTFrF’’); 
break  ; 
case  (3) : 
length  =  8  ; 
if(pflag  ==  0) 

I 

strcpy(col[0]. label  ,"Q") ; 
strcpy(colllJ.label,"R") ; 
strcpy(col[2J. label, "S") ; 

} 
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if(qflag  ==  0) 

I 

strcpy(colfO]. label, "P") ; 
strcpy(col[l  J. label, "R") ; 
strcpy(coll2J. label, "S") ; 

} 

if(rflag  ==  0) 

{ 

strcpy (coif 01. label, "P") ; 
strcpy(col[l].label,"Q") ; 
strcpy(col[2]. label, "S") ; 

} 

if(sflag  ==  0) 

I 

strcpy(colf01.1abel,"P") ; 
strcpy(col|l  J.label,"Q") ; 
strcpy(col[2].label,"R") ; 

} 

strcpy(col [0 1  element, "TTTTFFFF" ) ; 
strcpy(col|  1  J. element, "TTFFTTFF") ; 
strcpy  (col  1 2|  element,  "TFT Fl’FTF" ) ; 
break  ; 
case(2) : 
length  =  4  : 

if(pflag  =  0  &&  qflag  ==  0) 

I 

strcpy(col[0]. label, "R") ; 
strcpy(colf  1  J.label,"S") ; 

I 

if(pflag  ==  0  &&  rflag  ==  0) 

( 

strcpy(col[0].label,"Q") ; 
strcpy(col[l].label,"S") ; 

> 

if(pflag  ==  0  &&  sflag  ==  0) 

I 

strcpy(colfO].label,"Q") ; 
strcpy(colfl].label,"R") ; 

) 
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if(qflag  ==  0  &&  rflag  ==  0) 

{ 

strcpy(col(01. label, "P") ; 
strcpy(col[l].label,"S") ; 

} 

if(qflag  ==  0  &&  sflag  ==  0) 

I 

strcpy(coll()].label,"P") ; 
strcpy(col[lJ. label, "R") ; 

} 

if(rflag  ==  0  &&  sflag  ==  0) 

I 

strcpy(col[0].label,"P") ; 
strcpy(coIl  1J. label, "Q") ; 

) 

s(rcpy(col[0 1. element, "TTFF") ; 

strcpy(col[  1  J.element,"TFTF") ; 

bleak  ; 

case(l) : 

length  =  2  : 

if(pflag  ==  1 ) 

strcpy(col|OJ.label,"P") ; 
iflqflag  ==  1 ) 

strcpy(colfO].label,"Q") ; 
if(rflag  ==  1) 

strcpy(col[OJ.label,"R") ; 
iflsflag  ==  1 ) 

strcpy(col[0|.label,"S") ; 
strcpy(collUJ.element,"TF") ; 
break  ; 

I 

/* 

Copies  all  labels  into  the  names  of  the  structures  col[]. 

*/ 

fortdex  =  0;  dex  <  numcols;  dex  ++  ) 
strcpy(colldexJ.name,colldexJ.label) ; 
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/* 

Create  numstmg  with  col  numbers. 

*/ 

strcpy(inimstmg, input) ; 

for  (lvalue  =  0;  lvalue  <  numcols;  lvalue  ++  ) 

I 

ltoa(lvalue.replacenum,10) ; 
if(strcmp(col|lvalue] . label, "P")  ==  0) 
replstr(numstmg,colllvalue]. label, replacenum) ; 
if(strcmp(colllvalueJ. label, "Q”)  ==  0) 

replstr(numstmg,colllvalueJ. label, replacenum) ; 
if(strcmp(colll  value]. label, "R")  ==  0) 

replstr(numstmg,col[lvalue].label, replacenum) ; 
if(strcmp(colllvalue].label,,,S")  ==  0) 

replstr(numstmg,colllvulue]. label, replacenum) ; 

} 

/* 

Checks  the  input  string  for  negations. 

*/ 

negation(numstrng) ; 


Operates  on  the  expressions  inside  parens. 

*/ 

breakflag  =  0 ; 

for(  n=0;  n  <  strlen(numstmg);  n++) 

I 

dex  =  0  ; 

/* 

Counts  the  number  of  elements  up  to  the  first  closed  paren. 

*/ 

wliile(numstmgldex]  !=  ’)’ ) 

I 

dex  ++  ; 

if(dex  >  strlen(numstmg) ) 

{ 

breakflag  =  1  ; 
break  ; 

I 

I 
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if(breakflag  ==  1 ) 
break  ; 

frstclspar  =  dex  i  1  ; 

/* 

Find  matching  paren. 

*/ 

while(numstmg[dex]  !=  ’(’  &&  dex  >=  0  ) 
dex  —  ; 

frstopenpar  =  dex  ; 

/* 

Checks  the  location  of  the  closed  paren.  If  at  the  end  of  the 
input  string,  then  NULL  is  assigned  to  tempi.  Otherwise,  tempi 
is  assigned  the  string  to  the  right  of  the  closed  paren. 

*/ 

if(frstclspar  +  1  >  strlen(numstmg) ) 
strcpy  ( tempLnulline  ) ; 
else 

strcpy  ( tempi,  &numstmg[frstclspar]  )  ; 


/* 

Breaks  up  the  input  string  so  that  strings  inside  parens  may  be 
isolated. 

*/ 

strcpy  ( temp2,  numstmg  )  ; 

strcpy  (  &temp2[frstopenpar],  nulline  ) ; 

strcpy  ( temp3,  numstmg  ) ; 

strcpy  (  &temp3|frstclspar  -  1],  nulline  ) ; 

strcpy  ( temp3,  &temp3 [frstopenpar  +  1] ) ; 

/* 

Associated  functions  operate  on  the  string  inside  the  paren. 

*/ 

and(temp3 ) ; 
or(temp3) ; 
imply(temp3) ; 
iff(temp3) ; 
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/* 

Copies  the  relationship  iside  the  paren  to  the  col []. name 
structure  element.  Then,  reduces  the  value  in  tempi  to  a 
number  corresponding  to  the  next  column. 

*/ 

strcpy(tenipl,"("  ) ; 

strcat(templ,&collnumcols  -  l].name) ; 
strcat( tempi,")"  ) ; 

strcpy (&col | numcols- 1  ]. name, temp  1 ) ; 
strcpy(templ,"("  ) ; 
strcat(teinpl  .nextcol) ; 
strcat( tempi,")"  ) ; 

/* 

Removes  the  paren  from  numstring. 

*/ 

replstr(numstmg,templ , nextcol) ; 

I 

/* 

Perfonns  the  associated  functions  on  numstring. 

*/ 

negation(numstmg) ; 
and(numstrng) ; 
or(numstmg) ; 
imply(numstmg) ; 
iff(numstrng) ; 

/* 

Displays  the  propositions  on  the  screen. 

*/ 

dex  =  1  ; 

for(n  =  suinflag;  n  <  numcols;  n  ++) 

I 

strcpy(col[n].label,"P") ; 

lvalue  =  dex  ; 

ltoa(lvalue,templ,10) ; 

strcat(col|n]. label, tempi) ; 

wprintf("%s  :  %sVi",col[n]. label,  col[n].name) ; 

dex  ++  ; 

I 

wprintf("\n") ; 
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/* 

Displays  the  truth  table  column  heading  to  the  screen. 

*/ 

for(n  =  0;  n  <  numcols;  n  ++) 
if(strlen(col|nJ. label)  >  2) 
wprintf("%-4s".col[nJ. label) ; 

else 

wprintf("%-3s",col[n]. label) ; 
wprintf("\n") ; 

/* 

Displays  the  truth  table. 

*/ 

for(n  =  0;  n  <  length;  n  ++) 

{ 

for(dex  =  0;  dex  <  numcols;  dex  ++) 

I 

strcpy(templ  ,&colldexJ.element[n]) ; 
strcpy(&templll  J.'VOO ") ; 
if(strlen(col|dex]. label)  >  2) 
wprintf("  %-3s", tempi) ; 
else 

wprintf("%-3s",templ) ; 

} 

wprintf("\n") ; 


1 
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/********************************************************************** 


FUNCTION  : 
CALLED  BY: 


CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


replstr 

display_loop 

negation 

updatename 

strcpy 

strcat 

4/12/90 

Keith  Calcote 

Replaces  alphabetic  characters  with  numeric  characters 


static  void  replstr(char  strlj.chx  loc[],chr  rep[J) 

( 

char  tempi  181] ;  /*  Temporary  string  storage  */ 

int  dex, ind, test ;  /*  Counters  */ 

/* 

Replaces  all  occurances  of  loc[J  in  str[]  with  rep[J. 

V 

for  (  dex  =  0;  dex  <=  (  strlen(str)-strlen(loc)  );  dex  ++  ) 

( 

/* 

Prevents  the  loop  from  exiting  under  listed  conditions: 
needed  because  the  length  of  str  may  change  the  operation 
the  loop. 

*/ 

if(dex  <  0  II  dex  >  strlen(str) )  break  ; 

/* 

Locates  and  replaces  the  desired  string. 

*/ 

if(  (char)str(dex]  ==  (char)loc|0J  ) 

I 

test  =  0  : 
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/* 

Increments  test  for  each  matching  character. 

*/ 

for(ind  =  0;  inti  <  strlen(loc);  inti  ++  ) 

I 

if(  (char)str[ind  +  dex]  ==  (char)loc[ind]  ) 
test  ++  ; 

I 

/* 

If  the  entire  string  is  matched,  then  it  is  replaced. 

*/ 

if(  test  ==  strlen(loc) ) 

I 

strcpy(templ  ,&str[dex+test]) ; 
strcpy(&str[tlex],rep) ; 
strcat(str,templ) ; 

} 

) 

I 

} 
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/*  +  ***********  ^^if****************************************************** 


FUNCTION  : 
CALLED  BY: 


CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


findrhcol 

negation 

and 

or 

imply 

iff 

strcpy 

atoi 

4/12/90 

Keith  Calcote 

Identifies  and  returns  the  numeric  value  of  the  col  which  is 
on  the  imeediate  right  hand  side  of  the  operator. 


****il<*]fr************=l<**************!t<*’l<>l<*,t<>(,**lt<*’t<!l,*ll<l!'*,l<****"!'***Jt<**’i<****>l<>iy 


findrhcol(char  str[],  int  addr) 

( 

int  rhc  ;  /*  Numeric  value  of  the  col  on  the  right 

hand  side  of  the  operator  */ 

char  findtemp  [LEN]  ;  /*  Temporary  character  storage  */ 


strcpy(ftndtemp,&str[addr]) ; 
rhc  =  atoi(&str[addr+l  ]) ; 
retuni(rhc) ; 

} 
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/fr******************************************************************** 


FUNCTION  : 
CALLED  BY: 


CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


findlhcol 

negation 

and 

or 

imply 

iff 

strcpy 

atoi 

4/12/90 
Keith  Calcote 

Finds  the  left  hand  col  numerical  value. 


findlhcol  (char  str[),  int  addr) 

I 

int  lhc  ;  /* 


char  findtemp  [LEN]  ;  /* 

/* 

Places  the  incoming  string  into  temporary  storage  and  places  a 
NULL  character  at  the  end. 

*/ 

strcpy(findtemp.str) ; 
findtemp|addr+ 1 J  =  V00’  ; 

/* 

Locates  left  hand  values  that  are  zero  thru  nine. 


*/ 

if  ( strlen(findtemp)  < 

ill 

(char)strladdr-2]  == 

II 

(char)str|addr-2J  == 

T  II 

(char'str|addr-2]  == 

’>’  II 

(charjstrladdr-2J  == 

’=’  II 

(char)str[addr-2)  == 

’(’  II 

(char)strladdr-2]  == 

I 

lhc  =  atoi(&str[addr- 

y  > 

i]); 

) 


Numerical  value  of  the  col  to  the  left 
the  operator  */ 

Temporary  string  storage  */ 
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/* 

Locates  left  hand  values  that  are  greater  than  nine. 

*/ 

else 

I 

lhc  =  atoi(  &(char)str[addr-2] ) ; 

) 

retum(lhc) ; 

) 
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FUNCTION  : 
CALLED  BY: 

CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


negation 

display_loop 

replstr 

findrhcol 

strcat 

strcpy 

ltoa 

replstr 

4/12/90 

Keith  Calcote 

Finds  all  negations  on  col’s  and  updates  structure  with  neg 
col's 


*************************** ****** ****** ********* **********************/ 


negation!  char  str[] ) 

{ 

intdex,n;  /*  Counters  */ 


/* 

Investigates  every  character  in  str  for  negations. 

*/ 

for  (  dex  =  0:  dex  <  strlen(str);  dex  ++  ) 

{ 

/* 

Finds  the  column  number  to  the  immediate  right  of  the 
negation. 

*/ 

if  ( (char)str|dex]  ==  && 

(char)str|dex+lj  !=  && 

(char)str[dex+lj  !=  ’(’ ) 

I 

rhcol  =  findrhcol(str,dex) ; 
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/* 

For  each  element  in  the  column  to  the  right  of  the 
negation,  change  the  value  from  ’T’  to  ’F’  or  from 
’F’  to  T\ 

*/ 

for(n  =  0;n  <length;  n  ++) 

if(  col[rhcol].element[n]  ==  T* ) 

( 

col[numcols].element[n]  =  ’F’  ; 

I 

else 

I 

col[numcols].element[n]  =  ’T’ ; 


/* 

Create  the  proper  name  for  the  column  and  update  str. 

*/ 

col[numcolsl.namefO]  =  ; 

strcat(col|numcols].name,col[rhcol].name  ) ; 

strcpy(lastcol,"~") ; 

lvalue  =  rhcol ; 

ltoa(l  value, nextcol,  10) ; 

strcat(lastcol,nextcol) ; 

lvalue  =  numcols  ; 

ltoa(lvalue, nextcol, 10) ; 

replstr(str,lastcol,nextcol) ; 

numcols  ++  ; 

} 

} 

) 
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y*  Jit******  ***************************************  ********  *****  ********** 


FUNCTION  : 
CALLED  BY; 
CALLS  : 


MODIFIED  ; 
PERSON  : 
PURPOSE  : 


and 

display  Joop 

findrhcol 

fiiidlhcol 

undatename 

4/12/90 

Keith  Calcote 

Given  string  with  col  numbers  produces  AND  col 


**************  *********************  *****  I******************************/ 


static  char  and(char  str[J) 

I 

int  dex.  n  ;  /*  Counters  */ 

char  oper[LEN]  =  ;  /*  The  AND  operator  */ 

/* 

Investigates  each  character  for  the  AND  operator. 

*/ 

for  (dex  =  0;  dex  <  strlen(str);  dex  ++) 

I 

/* 

Locates  the  column  number  immediately  to  the  left  and  right 
of  the  AND  operator. 

*1 

if  ( (char)str[dex]  ==  ’&’) 

I 

rhcol  =  findrhcol(str,dex) ; 
lhcol  =  findlhcol(str,dex) ; 

/* 

Creates  a  new  column  with  values  equal  to  the  lhcol 
AND  rhcol. 

*/ 

for  (n  =  0;n  <  length;  n  ++) 

I 
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/* 

Determines  the  elements  in  the  new  row.  (T  or  F) 

*/ 

if(  (col[lhcol].element[n]  ==  T’)  && 
(col(rhcolJ.element[n]  ==  ’T’) ) 
col|numcols].element|n]  =  ’T’ ; 

»1c« 

col[numcolsJ.element[nJ  =  ’F’ ; 

} 

/* 

Updates  str  with  new  column  name. 

*/ 

updatename(oper,str) ; 
dex  —  ; 

) 

} 

} 
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^********i)(:tc***>!<)|<***!|t:)t*******!(<*’t'**s(<****  +  ******:|<**!!<*#******i|<J!<****:(<!|ei)i!|<i(<:(<i!<j|< 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED : 
PERSON  : 
PURPOSE  : 


or 

display_loop 

findrhcol 

findlhcol 

updatename 

4/12/90 

Keith  Cal  cote 

Given  string  with  col  numbers  produces  OR  col 


****************************************** **%***%**************%******/ 


static  char  or(char  str[]); 

I 

int  dex,  n  ;  /*  Counters  */ 

char  operlLENJ  =  "I"  ;  /*  The  OR  operator  */ 

/* 

Investigates  each  character  for  the  OR  operator. 

*/ 

for  (dex  =  0;  dex  <  strlen(str);  dex  ++) 

I 

/* 

Locates  the  column  number  immediately  to  the  left  and  right 
of  the  OR  operator. 

*/ 

if  ( (char )str [dex]  =  T) 

I 

rhcol  =  findrhcol (str, dex) ; 
lhcol  =  findlhcol(str,dex) ; 


327 


/* 

Creates  a  new  column  with  values  equal  to  the  lhcol 
OR  lhcol. 

*/ 

for  (n  =  0;n  <  length;  n  ++) 

I 

if(  (col[lhcol|.clcmcnt[nJ  ==  T’)  I! 
(co![rhcol].element[n]  ==  ’T’) ) 
col[numcols].element[nJ  =  ’T’ ; 
else 

col [numcols]. element |n]  =  ’F’  ; 

) 

/* 

Updates  str  with  new  column  name. 

*/ 

updatename(oper,str) ; 
dex  —  ; 

1 


) 
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y*  ********************************************************************* 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


imply 

display  _loop 

findrhcol 

findlhcol 

updatename 

4/12/90 

Keith  Calcote 

Given  string  with  col  numbers  produces  IMPLY  col 


**********************************************************************/ 


static  char  imply(char  str[] ) 

I 

int  dex,  n  ;  /*  Counters  */ 

char  oper[LEN]  =  ">"  ;  /*  The  IMPLY  operator  */ 

f* 

Investigates  each  character  for  the  IMPLY  operator. 

*/ 

for  (dex  =  0;  dex  <  stilen(str);  dex  +4 ) 

I 

/* 

Locates  the  column  number  immediately  to  the  left  and  right 
of  the  IMPLY  operator. 

*/ 

if  ( (char)str|dex]  ==  ’>’) 

{ 

rhcol  =  findrhcol(str.dex) ; 

Ihcol  =  findlhcol(str,dex ) ; 
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/* 

Creates  a  new  column  with  values  equal  to  the  lhcol 
IMPLY  rhcol. 

*/ 

for  (n  =  0;n  <  length;  n  ++) 

I 

if(  (colllhcol].element[n]  ==  T’) ) 

{ 

if(  coif  rhcol]  .element[n]  ==  ’T’) 
col [numcols]  .element [n]  =  *T’ ; 
else 

col  [numcols]  .element  [n]  =  ’F’ ; 

I 

else 

col[numcois].element[n]  =  ’T’  ; 


/* 

Updates  str  with  new  column  name. 

*/ 

updatename(oper,str) ; 
dex  —  ; 

) 


} 
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/♦♦I******************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


iff 

display_loop 

findrhcol 

findlhcol 

updatename 

4/12/90 

Keith  Calcote 

Given  string  with  col  numbers  produces  iff  col 


**********************************************************************/ 


static  char  iff(char  str[J) 

{ 

int  dex,  n ;  /*  Counters  */ 


char  oper[LEN|  =  "="  ; 


/*  The  IFF  operator  */ 


char  ltenip[LENJ.rtemp[LENJ  ;  /*  Temporary  character  storage  for 

left  hand  and  right  hand  side  of 
the  operator  */ 


/ * 

Investigates  each  character  for  the  IFF  operator. 

*/ 

for  (dex  =  0;  dex  <  strlen(str);  dex  ++) 

I 

/* 

Locates  the  column  number  immediately  to  the  left  and  right 
of  the  IFF  operator. 

*/ 

if  ( (char)str(dex]  ==  '=') 

I 

rhcol  =  findrhcol(str,dex) ; 
lhcol  =  findlhcol (str, dex) ; 
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/* 

Creates  a  new  column  with  values  equal  to  the  lhcol 
IFF  rhcol. 

*/ 

for  (n  =  0;n  <  length;  n  ++) 

{ 

/* 

Isolates  the  individual  row  elements. 

*/ 

strcpy(ltemp,&col[lhcolJ.element[n] ) ; 
ltempl  1 1  =  VOO’ ; 

strcpy(rtemp,&col|rhcol].element[n]  ) ; 
rtempl  1 J  =  '\xO0'  ; 

/* 

Perfonns  the  IFF  operation 

V 

if(  strcmp(ltemp:rtemp)  ==  0  ) 
col|numcolsJ.elementlnJ  =  ’T’  ; 
else 

col[numcols].element[n]  =  ’F’  ; 

I 

/* 

Updates  str  with  new  column  name. 

*/ 

updatename(oper,str)  ; 
dex  —  ; 

} 

} 

} 
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^l*************  Jit*  Jfc*********************  ******  Jit******  **  ******  ***********S| 


FUNCTION  : 
CALLED  BY: 


CALLS 


MODIFIED  : 
PERSON  : 
PURPOSE  : 


updatenaine 

display  _loop 

imply 

iff 

and 

or 

strcpy 

strcat 

Itoa 

4/12/90 
Keith  Calcote 

Update  col[J  name  give  the  operator  as  input  string 
also  updates  numstmg  with  number  of  new  col 


*****  •****************************************************************/ 


static  void  updatename(char  str[]  ,char  origstr[]) 

{ 

/* 

Creates  column  name. 

*/ 

strcpy(col|nuincols].name,colllhcol].name  ) ; 
strcat(collnumcols].name,str) ; 
strcat(collnumcolsj.name,collrhcol].name  ) ; 

/* 

Converts  column  name  into  numerical  equivalent. 

*/ 

lvalue  =  lhcol  ; 

Ito;.  (lvalue, nextcol,  1C,1 ; 
strcpy(lastcol.nextcol) ; 
strcat(lastcol.str) ; 
lvalue  =  rhcol  ; 
hoa(lvalue,nextcol,10) ; 
strcat(lastcol.nextcol) ; 


/* 

Replaces  all  occurances  of  lasted  in  numstring  and  origstr 
with  the  numerical  value  of  nextcol. 

*/ 

lvalue  =  numcols  ; 
ltoa(lvalue,nextcol.lO) ; 
replstr(numstmg, lasted, nextcol) ; 
replstr(origstr,lastcol, nextcol) ; 
numcols  ++  ; 
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FUNCTION  : 
CALLED  BY. 
CALLS  : 

MODIFIED  : 
PERSON  : 
PURPOSE  : 


error_response 
display  _loop 
wcenters 
display  _loop 
4/12/90 

Keith  Calcote  &  Rick  Howard 

Displays  die  appropriate  error  message  for  known  errors 


*  *  *  *  **  *  *  *  *****  **  *  **  I***********  *  ****  *  *  *  ************  ***  *  *******  *  ***  ****  * 


static  void  error_response(int  num) 

I 

switcli  (num){ 
case  lNPUT_ERROR: 

wcenters(10,BLUEI_RED, "Invalid  Input"); 
break; 

case  PARENJVIISMATCH: 

wcenters(10,BLUEI_RED, "Unmatched  Paren"); 
break; 

case  INVALID_CHAR: 

wcenters(l  O.BLUEI_RED, "Incorrect  Character"); 
break; 
default: 
break; 

} 

display  _loop(); 

} 
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FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


pause 

display  _loop 

wcenters 

4/12/90 

Keith  Calcote  &  Rick  Howard 

Makes  the  user  press  any  key  to  continue  in  the  program 


****!<c]tc*:|<*]t<!tt!|c:fc!|<**:|<***:|c*****]|(*******!|<**!t(!t'!tt*%!fc**]tt***%*****i|c************** 


static  void  pause(void) 


char  key;  /*  The  user’s  response  */ 


wcenters(18.BLINKIYELLOWLBROWN,"Push  any  key  to  continue") ; 
key  =  getch() ; 

) 


/********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


quit 

table 

exit 


4/12/90 

Keith  Calcote  &  Rick  Howard 
Terminates  the  program 


static  void  quit(void) 

I 

exit(0); 

} 
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/***************************★*★*********************************★****** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


pre_hlep 

table 

wshadow 

4/12/90 

Keith  Calcote  &  Rick  Howard 

Displays  a  shadow  behind  the  current  window 


**************************************************************** ****** j 


static  void  pre_help(void) 

I 

wshadow(LGREYLBLACK); 
setonkey(0x2d00,quit,0 ); 

) 
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APPENDIX  Q 


THE  CODE:  FILE  "GLOBAL.H" 


^♦♦Hc****************************************************************** 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 

NONE 


PROGRAM  CALLS: 

NONE 

GLOBAL  FUNCTIONS: 


COMPLETED: 


4/12/90 


PERSONS: 


Rick  Howard 


PURPOSE: 


Global  variables  for  the  Discrete  Math  Turtor 


/*  Constants  */ 


#define  SHORT_DELAY  1 1 
#define  LEN  50 
#define  PAGEL  1000 
#define  TRUE  1 
#define  FALSE  0 
#define  ESC  0x01  IB 

/* - */ 
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/*  miscellaneous  global  variables  */ 

static  int  crow,ccol; 

static  WINDOW  w[10]; 

static  int  fromjsn  =  FALSE; 

program 

FILE  *current_notebook; 
static  char  notebook_name[12]; 
int  def_number: 

int  start_up  =  1 ; 

/* - 


/*  Indicates  the  row  and  column  of  the  cursor 

/*  Handles  used  to  identify  some  windows 

/*  Indicates  functions  called  from  the  lsn.exe 
*/ 

/*  Pointer  to  die  user’s  notebook  file  */ 

/*  The  user’s  notebook  name  */ 

/*  Identifies  the  array  element  chosen  in  the 
definitions  table  */ 

/*  Indicates  that  no  lesson  has  begun  yet  */ 
- */ 


V 

V 


/*definitions  table  */ 


static  char  *definitions[]=  { 

"Graph",  "Definition  2",  "Definition  3",  "Definition  4", 

"Definition  5",  "Definition  6",  "Definition  7”,  "Definition  8", 
"Definition  9".  "Definition  10",  "Definition  11",  "Definition  12",  NULL 
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APPENDIX  R 


THE  CODE:  FILE  "VIDEO.H" 


/*********************************************************************** 


The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 

biosequip 

sefvparam 

videoinit 


Turbo  C  Lib 
CXL  Lib 
CXL  Lib 


PROGRAM  CALLS: 

NONE 


VIDEO  FUNCTIONS: 

set_video 


COMPLETED:  4/12/90 

PERSONS:  Rick  Howard 


PURPOSE:  Sets  the  correct  parameters  for  any  type  of  monitor 

**********************************************************************/ 
static  void  set_video(void) 

I 

unsigned  int  eq.  data; 

videoinitO; 
eq  =  biosequipO; 

data  =  (eq  »  4)  &  3;  /*  bits  4  &  5  */ 
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switch  (data) 

I 

case  J: 

setvparam(VP_CGA); 
break;  /*  40  column  color  */ 
case  2: 

se  t  vparam(  VP_CG  A ); 
break;  /*  80  column  color  */ 
case  3: 

setvparam(VP_MONO); 

break;  /*  80  column  monochrome  */ 
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APPENDIX  S 


THE  CODE:  FILE  "F’LASH.C" 


I********************************************************************** 

The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 


cleardevice 

Turbo  C  Lib 

clearviewport 

Turbo  C  Lib 

delay 

Turbo  C  Lib 

detectgraph 

Turbo  C  Lib 

geteh 

Turbo  C  Lib 

getmaxx 

Turbo  C  Lib 

getmaxy 

Turbo  C  Lib 

grapherrormsg 

Turbo  C  Lib 

graphresult 

Turbo  C  Lib 

initgraph 

Turbo  C  Lib 

itoa 

Turbo  C  Lib 

outtext 

Turbo  C  Lib 

print  f 

Turbo  C  Lib 

puts 

Turbo  C  Lib 

randomize 

Turbo  C  Lib 

rectangle 

Turbo  C  Lib 

setkbcolor 

Turbo  C  Lib 

settextstyle 

Turbo  C  Lib 

setviewport 

Turbo  C  Lib 

strcat 

Turbo  C  Lib 

strcpy 

Turbo  C  Lib 
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PROGRAM  CALLS: 

NONE 

FLASH  FUNCTIONS: 

NONE 

COMPLETED:  4/12/90 

PERSONS:  Keith  Calcote 


PURPOSE:  Provides  the  user  with  a  set  of  flash  cards  that  test  his 

knowledge  on  simple  logic  statements 


/*  header  files  */ 


#include  <graphics.h> 
#include  <stdlib.h> 
#include  <string.h> 
#include  <tinie.h> 
#include  <dos.h> 


/*■ 


-*/ 


/*  constants  */ 


#define  FONT  0 
#define  CHSIZE  5 

I* _ *i 
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/*********************************************************************** 


FUNCTION  : 
CALLED  BY: 
CALLS  : 
MODIFIED  : 
PERSON  : 
PURPOSE  : 


main 

NONE 

See  Declarations 
4/12/90 
Keith  Calcote 
See  Declarations 


*********************************** t**********************************/ 

niainO 

( 

int  driver  .mode  ;  /*  graphics  driver  &  mode  number  */ 

int  lhvalue.rh value, operator  ;  /*  Holds  the  value  to  the  left  hand 

side  and  right  hand  side  of  the 
operator;  either  zero  or  one  */ 

int  maxx.maxy  ;  /*  The  largest  values  in  the  x  &  y 

direction  for  any  type  of  video 
screen  */ 

int  left, top, right, bottom  ;  /*  Holds  the  pixel  location  to  the 

corresponding  region  on  the 
screen  */ 

int  answer ;  /*  User’s  response  */ 
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int  scorel4][2]  = 


/*  The  results  for  each  of  the  four 
different  operators  */ 


0,0 


0,0 


0,0  } 

0.0  ) 


char  lhchar[5J.  rhchar[5J; 
char  opchar[5J; 
char  anchar[5]: 

char  outputch[15] ; 

char  ch, string  [10] ; 


/*  Either  TRUE  or  FALSE  */ 

/*  OR,  AND,  IMPLIES  or  IFF  */ 

/*  User's  response:  Either  TRUE 
or  FALSE  */ 

/*  Flashcard  that  is  presented  to 
the  screen  */ 

/*  Multi-purpose  character  array  */ 


I* 

Initialize  the  PC  graphics  drivers. 

V 

detectgraph  (  &driver  ,  &mode) ; 
initgraph  (  &driver,  &mode  ,  NULL) ; 
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/* 

Check  for  errors  on  graphics  driver  initialization. 

*/ 

error  =  graphresultQ; 
if  (error){ 

printf("Error  %d  \n",  error); 
errptr  =  grapherrormsg(error); 
puts(errptr); 
exit(l); 


/* 

Set  the  background  screen  color  to  BLUE. 

*/ 

setbkcolor(  l ): 

/* 

Retrieve  the  largest  x  &  y  values  for  the  user's  screen. 

*/ 

inaxx  =  getmaxx() ; 
maxy  =  getmaxyO  ; 

/* 

Sets  the  coordinates  for  die  flashcard. 

*/ 

left  =  maxx/6  : 
right  =  maxx*  5/6  ; 
top  =  maxy  /3  ; 
bottom  =  maxy  *  2/3; 
randomize! ) ; 

/* 

Set  the  font. 

*/ 

settextstyle(FONT+l,0,CHSIZE) ; 
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/* 

Draw  the  opening  screen. 

*/ 

moveto(maxx/2,maxy/2-75) ; 
settextjustify(l,l ) ; 
outtext("  Welcome  to  ") ; 
moveto(maxx/2,maxy/2+20) ; 
settextstyle(FONT+l,0,4) ; 
outtext("  Basic  Trutii  Table  Practice  ") ; 
moveto(maxx/2,maxy-20) ; 
settextstyle(FONT,0,l) : 
outtext("Q  (quit),  Any  other  key  begins") ; 

/* 

Get  the  user’s  response. 

*/ 

ch  =  getch() ; 

if(ch  !=  ’q’  &&  ch  !=’Q') 


while(ch  !=  ’q’&&  ch  !=’Q’) 

{ 

cleaideviceO  ; 

rectangledeft,  top,  right,  bottom) ; 

/ * 

Randomly  choose  the  value  of  the 
left  side  of  the  equation. 

*/ 

lhvalue  =  random(2) ; 
switch(lhvalue) 

( 

case  0 : 

strcpy(lhchar,  "  F  ") ; 
break  ; 
default : 

strcpy(lhchar,  "  T  ") ; 

} 
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/* 

Randomly  choose  the  value  of  the 
right  side  of  the  equation. 

*/ 

rhvalue  =  random(2) ; 
switch(rhvalue) 

{ 

case  0  : 

strcpy(rhchar,"  F  ") ; 
break  ; 
default  : 

strcpy(rhchar,"  T  ") ; 

} 


/* 

Randomly  choose  the  equation  operator  and 
determine  the  correct  answer  for  the  equation. 

*/ 

operator  =  random(4) ; 
switch(operator) 

I 

case  0  : 

strcpy  (opchar,"AV) ;  /*  and  */ 
answer  =  (lhvalue  &&  rhvalue) ; 
break  : 
case  1  : 

strcpy  (opchar,'\V") ;  /*  or  */ 
answer  =  (lhvalue  II  rhvalue) ; 
break  ; 
case  2  : 


strcpy  (opchar, "==>") ;  /*  if... then  */ 
if(lhvalue  ==  0) 
answer  =  1 
else  if(rhvalue  =  0) 
answer  =  0 
else 


answer  =  1 
break  ; 


348 


case  3  : 

strcpy  (opchar."<==>") ;  /*  iff  */ 
if(lhvaiue  ==  rhvalue ) 
answer  =  1  ; 
else 

answer  =  0 ; 
break  ; 

I 

/* 

Prepare  the  answer  for  display. 

*/ 

switch(answer) 

{ 

case  0 : 

strcpy(anchar,"  F  ") ; 
break  ; 
default  : 

strcpy(anchar,"  T  ") ; 

) 

/* 

Display  the  equation. 

*/ 

strcpy(outputch,lhchar) ; 
strcat(outputch.opchar) ; 
strcat(outputch,rhchar) ; 
settextstyle(FONT,0,CHSIZE) ; 
moveto(maxx/2,maxy/2) ; 
settextjustify(l,l) ; 
outtextfoutputch ) ; 

/* 

Get  the  user’s  answer  to  the  equation. 

V 

settextstyle(FONT,  0,  1) ; 
movetoUeft,  bottom+top/4) ; 
settextjustify(0,0) ; 

outtext( "press:  T  (true),  F  (false),  Q  (quit)") ; 
nioveto(left,  bottom+top/2) ; 

setviewport(left,bottom+top/2,left+50,bottom+top/2+25,0) ; 
ch  =  getch() ; 
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Based  upon  the  user’s  answer,  inform  him  if  lie  was 
correct  or  incorrect. 


/* 


*1 

switch(ch) 

{ 

case  T’  : 
case  V  : 

iff  answer  ==  1) 

I 

score[operator][0]  ++  ; 
outtextf"  CORRECT  ") ; 
delay(2000) ; 
clearviewpoilO  ; 

} 

else 

{ 

score[operatorl[l]  ++  ; 
outtextf"  WRONG  ") ; 
delay(2000) ; 
clearviewportO  ; 

) 

break  ; 
case  ’F’  : 
case  ’f  : 

iff  answer  ==  0) 

I 

score[operator||0]  ++  ; 
outtextf"  CORRECT  ") ; 
delay(2000) ; 
clearviewportf) ; 

) 

else 

I 

score[operator]fl]  ++  ; 
outtextf"  WRONG  ") ; 
delay(2000) ; 
clearviewportf) ; 

} 

break  ; 
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case  ’q’  : 
case  ’Q’  : 
ch=  Y; 
break  ; 
default : 

setvie\vport(0,0.niaxx,maxy,0) ; 
ntoveto(left,  bottom+top/2) ; 
outtext("incorrect  entry  QUITTING" ) ; 
ch  =  ’q'  ; 

} 

setviewpoit(0,0,maxx,maxy,0) ; 
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/* 

When  the  user  quits,  display  his  results. 

*/ 

cleardeviceO  ; 
moveto(0,20) ; 
outtext("AND  ") ; 
itoa(scorel0J[0], string,  10) ; 
outtext(string) ; 
outtext("  correct  ") ; 
itoa(score[0J(l], string, 10) ; 
outtext(string); 
outtext("  incorrect  ") ; 
moveto(0,40) ; 
outtext("OR  ") ; 
itoa(seore[l][0],string,10) ; 
outtext(string) ; 
outtext("  correct  ") ; 
itoa(scorell  J[lJ,string,10) ; 
outtext(string); 
outtext("  incorrect  ") ; 
moveto(0,60) ; 
outlextflMPLY  ’’) ; 
itoa(score[2][0], string, 10) ; 
outtext(string)  ; 
outtext("  correct  ") ; 
itoa(scorel2J[lJ, string,  10) ; 
outtext(string); 
outtext("  incorrect  ") ; 
moveto(0,80) ; 
outtext("IFF  "); 
itoa(score[3][0],string,10) ; 
outtext(string) ; 
outtext("  correct  "); 
itoa(score|3J[lJ, string, 10) ; 
outtext(string); 
outtext("  incorrect  ") ; 
gctch() ; 

) 

closegraph() ; 

) 
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APPENDIX  T 


THE  CODE:  FILE  "HELP.H" 


^******************************4^************************************** 


The  Discrete  Math  Tutor  (DMT) 

Thesis  Project  at  the  Naval  Postgraduate  School 
1989-1990  by  Keith  Calcote  and  Rick  Howard 


LIBRARY  CALLS: 

NONE 


PROGRAM  CALLS: 

NONE 


HELP  FUNCTIONS: 

NONE 


COMPLETED:  4/12/90 

PERSONS:  Rick  Howard 

PURPOSE:  Identifies  constants  that  relate  directly  to  each  help  screen 

in  the  Discrete  Math  Tutor 


*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  **  *  * + *  *  *  *  *  **  *  *  *  *  *  *  *  *  * + *  *  *  *  *  *  *  *  *  *  *  *  * + *  * + *  *  *  *  ★  *  *  *  *  *  *  * 


/*  help  category  numbers  */ 


#define  HJTNITIAL  1 

#define  H_USER_INTERFACE  2 

#define  H_START_LSN  3 

#define  H_RETURN_TO_LAST_LSN  4 

#define  H_SSN  5 

#define  H_LOGIC  6 

#define  H_LSN_HELP  7 

#define  H_DEFINITIONS  8 

#define  H_EXAMPLES  9 

#define  H.THEOREMS  10 

#define  H_SELECT  1 1 

#define  H  PICTURES  12 
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#define  H_REFERENCE  13 

#define  H_CALCULATOR  14 

#define  H_PROBLEM_SOLVER  15 

#define  H_VENN_DIAGRAM_PICS  16 

#define  H_TRUTH_TABLE_REF  17 

#define  H_CALCULATOR_HELP  18 

#define  H_TR  UTH_T AB  LE_PROB  LEM_S  OL VER  19 
#define  H_TRUTH_TABLE_DRILL  20 

#defme  H_TRUTH_T AB  LE_R  ULES  21 

#defiiie  H_VlEW_NOTEBOOK  22 

#define  H_VlEW_NOTEBOOK_HELP  23 

#define  H_PRINT_N OTEB  OOK  24 

#define  H_SAVE_POSITION  25 

#define  H_EXIT  26 

#define  H_UNAVAILABLE  27 

#define  H  EXAMS  28 
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